ActivationKing

ActivationKing MCP

将你的 AI 助手连接到你的 ActivationKing 账户。

ActivationKing 在现场活动中提供照相亭、AI 体验和游戏。此 MCP 服务可让 AI Agent（Claude、Cursor 及其他 MCP 客户端）读取你自己的 ActivationKing 数据并管理你的运营日历：查询活动和嘉宾会话、检查额度，以及创建或更新公司、活动任务和商机，例如将 CRM 中已赢单的商机直接推送到运营系统，创建为任务。

端点	https://api.activationking.com/mcp
传输方式	MCP Streamable HTTP（无状态）
身份验证	Authorization: Bearer ak_live_...（个人 API 密钥）
速率限制	每个密钥每分钟 300 次请求
参考资料	llms.txt · llms-full.txt · OpenAPI · 交互式文档

此仓库包含连接指南、Claude Code 插件和 MCP Registry 清单。服务本身由 ActivationKing 托管，无需安装或运行任何内容。

1. 获取 API 密钥

1. 登录 activationking.com/dashboard/api-keys。
2. 创建密钥。密钥以 ak_live_ 开头，且只会显示一次。
3. 将其存储为环境变量，而不是粘贴到配置文件中：

# macOS / Linux
export ACTIVATIONKING_API_KEY="ak_live_..."

# Windows (persists for new terminals)
setx ACTIVATIONKING_API_KEY "ak_live_..."

密钥只能访问创建该密钥的用户的数据。运营日历工具还会遵循该用户在各组织中的角色权限。

2. 连接客户端

Claude Code：插件（推荐）

该插件会添加服务，以及一个教 Claude 如何安全使用这些工具的技能。

/plugin marketplace add activationking/activationking-mcp
/plugin install activationking@activationking

确保 ACTIVATIONKING_API_KEY 已设置在 Claude Code 启动时所用的环境中。

Claude Code：仅连接服务

claude mcp add --transport http activationking https://api.activationking.com/mcp \
  --header "Authorization: Bearer ${ACTIVATIONKING_API_KEY}"

Cursor

~/.cursor/mcp.json（或项目中的 .cursor/mcp.json）：

{
  "mcpServers": {
    "activationking": {
      "url": "https://api.activationking.com/mcp",
      "headers": {
        "Authorization": "Bearer ${env:ACTIVATIONKING_API_KEY}"
      }
    }
  }
}

Claude Desktop

Claude Desktop 的配置文件会启动本地服务，因此请使用 mcp-remote 桥接工具（需要 Node.js）。编辑 claude_desktop_config.json：

{
  "mcpServers": {
    "activationking": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://api.activationking.com/mcp",
        "--header", "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer ak_live_..."
      }
    }
  }
}

其他 MCP 客户端

任何支持携带自定义标头的 Streamable HTTP 的客户端都可以使用：将其指向 https://api.activationking.com/mcp，并发送 Authorization: Bearer <your key>。

Web 连接器（claude.ai、ChatGPT）： 这些连接器通过 OAuth 登录添加远程服务。目前 ActivationKing MCP 仅使用 API 密钥进行身份验证，因此 Web 连接器暂时无法连接。请使用上述任一客户端。

3. 可执行的操作

可以尝试以下提示词：

• “列出我上个月的活动，并显示每场活动的会话数。”
• “活动 Summer Launch 使用了多少张打印件和 AI 额度？”
• “我的 AI 额度余额是多少？”
• “将这个 CRM 商机创建为运营任务：客户 Acme，照相亭，3 月 14 日至 15 日，地点柏林，价格 2,400 EUR。”
• “将 Acme 任务的商机状态改为 Won，并添加一项额外打印站。”

工具

包含所有参数的权威且始终保持最新的列表，请参阅 llms.txt 和 llms-full.txt。简要列表如下：

类别	工具
账户	get_account、get_credit_balance
活动和场次	list_events、get_event、get_event_stats、list_event_sessions、get_session
Ops Calendar（读取）	ops_reference_data、ops_list_companies、ops_get_company、ops_list_jobs、ops_get_job、ops_get_deal
Ops Calendar（写入）	ops_save_company、ops_save_job、ops_update_deal、ops_delete_company、ops_delete_job

Ops 工具的工作方式：

• 组织： Ops 工具需要 organizationId。调用 get_account 可查看你所属的组织。
• 参考值： 阶段、活动和场地类型、成员 ID、产品及交易状态来自 ops_reference_data。
• 从 CRM 同步且不产生重复项： 将 externalSource + externalId（你系统中的 ID）传递给 ops_save_company / ops_save_job。首次调用会创建记录；后续使用相同组合调用时会更新记录。
• 部分更新： 仅更改你传入的字段。
• 新建工作会自动开启一笔交易； 使用 ops_update_deal 设置其状态、币种和价格明细。
• 权限 取决于你在组织中的角色（例如，交易需要 Deal.View / Deal.Edit）。组织需要订阅 Ops Calendar；未订阅时，Ops 工具会返回错误。
• 写入工具带有注释（readOnlyHint / destructiveHint），因此 MCP 客户端在调用前会请求确认。

安全

• 像保护密码一样保护你的 API 密钥。切勿将其提交到代码库、粘贴到共享配置中或放入提示词。
• 建议使用环境变量（如上方示例所示）。
• 如果密钥泄露，请在 activationking.com/dashboard/api-keys 撤销该密钥并创建新密钥。
• 在客户端中批准创建、更新、删除等写入操作前，请先检查。

支持

• API 参考文档：api.activationking.com/docs
• 有关此代码库的问题：请创建 GitHub issue。
• 账户或数据问题：请通过 activationking.com 联系 ActivationKing 支持团队。

许可证

MIT