文档目录

用 MCP 连接 AI 助手

更新于 2026年11月17日

管理员在 Velotrak 后台创建令牌。客户端向追踪器源站的 POST /mcp 发送 Authorization: Bearer vtmcp_…。编辑和删除会先返回 diff,并等待同一次调用带上 diff_token。Free 的令牌只读。

创建令牌

只有管理员能创建 MCP 令牌(GET、POST 和 DELETE /api/mcp-tokens)。明文令牌只显示一次。它以 vtmcp_ 开头。服务器保存 SHA-256 哈希、权限 JSON、创建者和过期时间。省略 days 时,过期时间是 90 天。最长 365 天。省略权限时,令牌是 {"reports":{"read":true}}。

创建者必须一直是活动的管理员。停用该用户或改变其角色后,令牌无法通过认证。数据库里的行可以还在。Free 和 Pro 允许一个未过期的令牌(按活动管理员创建者计数)。Team 存的是不限制的上限。定价页把 Team 写成每位队友一个令牌;程序实际执行的授权是不限制。见套餐。

把客户端指到 POST https://<你的主机>/mcp。路径在站点根上,不在 /admin/ 下面。请求头是 Authorization: Bearer <令牌>。服务器宣布的协议版本是 2025-03-26。

权限和确认

权限形如 { "<领域>": { "read": true, "write": true } }。后台把领域分成:活动、Offer、落地页、Flow、流量源、联盟、域名、报表和日志;告警、备份、迁移、系统和用户管理;以及敏感领域:集成、授权和落地页文件。* 不覆盖敏感领域,也从不授予标成 explicit-only 的工具(改品牌、恢复备份和清除演示数据都在其中)。对某个领域没有写权限的令牌看到的是打过码的凭据。

写工具需要 Pro 或以上(mcp_write)。Free 上会被拒绝,例外是 activate_license。破坏性调用不会在第一次请求时执行。响应包含 requires_confirmation、一个 diff_token,以及 expires_in_seconds 为 600。用同一工具、同一参数再发一次,并带上这个 diff_token。

工具列表

下面的表在构建时从追踪器源码的 Registry() 生成。定价页和首页仍写 90 个工具。这张表是注册表和 CI 检查与服务器实际注册的工具保持一致的那份名单。有一个后台路由没有对应工具:PATCH /api/integrations/{id} 用来更新集成,注册表里只有创建、删除、列表和 sync_costs。

MCP 工具

共 94 个工具,读取自本仓库的产品注册表。
功能REST工具
Click logGET /api/logs/clicksget_click_log
Conversion logGET /api/logs/conversionsget_conversion_log
Postback logGET /api/logs/postbacksget_postback_log
Outbound logGET /api/logs/outboundget_outbound_log
Report queryPOST /api/reports/queryreport_query
Dashboard summaryGET /api/dashboarddashboard_summary
Export report csvPOST /api/reports/exportexport_report_csv
List report viewsGET /api/reports/viewslist_report_views
Save report viewPOST /api/reports/viewssave_report_view
Delete report viewDELETE /api/reports/views/{id}delete_report_view
Clone campaignPOST /api/campaigns/{id}/cloneclone_campaign
Clone offerPOST /api/offers/{id}/cloneclone_offer
Clone flowPOST /api/flows/{id}/cloneclone_flow
Campaigns: listGET /api/campaignslist_campaigns
get_campaignGET /api/campaigns/{id}get_campaign
create_campaignPOST /api/campaignscreate_campaign
update_campaignPATCH /api/campaigns/{id}update_campaign
delete_campaignDELETE /api/campaigns/{id}delete_campaign
Offers: listGET /api/offerslist_offers
get_offerGET /api/offers/{id}get_offer
create_offerPOST /api/offerscreate_offer
update_offerPATCH /api/offers/{id}update_offer
delete_offerDELETE /api/offers/{id}delete_offer
Landers: listGET /api/landerslist_landers
get_landerGET /api/landers/{id}get_lander
create_landerPOST /api/landerscreate_lander
update_landerPATCH /api/landers/{id}update_lander
delete_landerDELETE /api/landers/{id}delete_lander
Sources: listGET /api/traffic-sourceslist_traffic_sources
get_traffic_sourceGET /api/traffic-sources/{id}get_traffic_source
create_traffic_sourcePOST /api/traffic-sourcescreate_traffic_source
update_traffic_sourcePATCH /api/traffic-sources/{id}update_traffic_source
delete_traffic_sourceDELETE /api/traffic-sources/{id}delete_traffic_source
Networks: listGET /api/networkslist_networks
get_networkGET /api/networks/{id}get_network
create_networkPOST /api/networkscreate_network
update_networkPATCH /api/networks/{id}update_network
delete_networkDELETE /api/networks/{id}delete_network
rotate_network_keyPOST /api/networks/{id}/rotate-keyrotate_network_key
Domains: listGET /api/domainslist_domains
get_domainGET /api/domains/{id}get_domain
create_domainPOST /api/domainscreate_domain
update_domainPATCH /api/domains/{id}update_domain
delete_domainDELETE /api/domains/{id}delete_domain
Flows: listGET /api/flowslist_flows
get_flowGET /api/flows/{id}get_flow
create_flowPOST /api/flowscreate_flow
update_flowPATCH /api/flows/{id}update_flow
delete_flowDELETE /api/flows/{id}delete_flow
Get flow docGET /api/flows/{id}/docget_flow_doc
Set flow docPUT /api/flows/{id}/docset_flow_doc
Simulate flowPOST /api/flows/{id}/simulatesimulate_flow
List lander filesGET /api/landers/{id}/fileslist_lander_files
Read lander fileGET /api/landers/{id}/files/{path}read_lander_file
Write lander filePUT /api/landers/{id}/files/{path}write_lander_file
Delete lander fileDELETE /api/landers/{id}/files/{path}delete_lander_file
Lander preview linkPOST /api/landers/{id}/preview-linkget_lander_preview_link
License statusGET /api/licenselicense_status
Activate licensePOST /api/license/activateactivate_license
License heartbeatPOST /api/license/heartbeatlicense_heartbeat
List integrationsGET /api/integrationslist_integrations
Create integrationPOST /api/integrationscreate_integration
Delete integrationDELETE /api/integrations/{id}delete_integration
Sync costsPOST /api/integrations/{id}/syncsync_costs
Enter manual campaign spendPOST /api/campaigns/{id}/costrecord_campaign_cost
List manual campaign spendGET /api/campaigns/{id}/costlist_campaign_cost
Check domainPOST /api/domains/{id}/checkcheck_domain
List alertsGET /api/alertslist_alerts
Create alertPOST /api/alertscreate_alert
Update alertPUT /api/alerts/{id}update_alert
Delete alertDELETE /api/alerts/{id}delete_alert
List alert eventsGET /api/alerts/eventslist_alert_events
List backupsGET /api/backupslist_backups
Create backupPOST /api/backupscreate_backup
Restore backupPOST /api/backups/restorerestore_backup
System healthGET /healthzsystem_health
List usersGET /api/userslist_users
Audit logGET /api/auditaudit_log
Get brandingGET /api/bootstrapget_branding
List bot rulesGET /api/bot-ruleslist_bot_rules
Get custom metricsGET /api/settings/custom-metricsget_custom_metrics
Set custom metricsPUT /api/settings/custom-metricsset_custom_metrics
Get update statusGET /api/system/updateget_update_status
Check for updatePOST /api/system/update/checkcheck_for_update
Download updatePOST /api/system/update/downloaddownload_update
Create bot rulePOST /api/bot-rulescreate_bot_rule
Delete bot ruleDELETE /api/bot-rules/{id}delete_bot_rule
Set brandingPUT /api/settings/brandingset_branding
Migration: export configGET /api/exportexport_config
Migration: import configPOST /api/importimport_config
Migration: list templatesGET /api/templateslist_templates
Migration: apply templatePOST /api/templates/applyapply_template
Migration: generate demoPOST /api/demo/generategenerate_demo
Migration: clear demoPOST /api/demo/clearclear_demo