MCP 集成指南

MrKop One API 支持 Model Context Protocol (MCP)，提供企业管理和 API 调用的 MCP 工具。

什么是 MCP

MCP 是 AI 模型与外部工具之间的标准化协议。通过 MCP，AI 助手可以：

管理企业 API 密钥
查询使用统计
代理发送 API 请求

连接方式

使用 API Key 认证（推荐）

json

{
  "mcpServers": {
    "mrkop": {
      "url": "https://gw.mrkop.com/mcp/sse",
      "headers": {
        "Authorization": "Bearer mrkop-xxxx"
      }
    }
  }
}

使用 JWT 认证

先通过 /v1/auth/login 获取 JWT Token，然后：

json

{
  "mcpServers": {
    "mrkop": {
      "url": "https://gw.mrkop.com/mcp/sse",
      "headers": {
        "Authorization": "Bearer <jwt_token>"
      }
    }
  }
}

可用 MCP 工具

企业密钥管理

工具	说明
`enterprise_list_keys`	列出企业所有 API 密钥
`enterprise_create_key`	创建企业 API 密钥
`enterprise_toggle_key`	启用/禁用密钥
`enterprise_delete_key`	删除密钥

企业信息查询

工具	说明
`enterprise_get_stats`	获取企业使用统计
`enterprise_list_members`	列出企业成员
`enterprise_get_wallet`	查询企业钱包余额
`enterprise_get_models`	获取可用模型列表

代理调用

工具	说明
`proxy_chat`	通过代理发送聊天请求

调试 MCP 连接

检查 MCP 工具列表：

bash

curl -H "Authorization: Bearer <api_key>" https://gw.mrkop.com/mcp/tools

调用单个工具：

bash

curl -X POST -H "Authorization: Bearer <api_key>" \
  -H "Content-Type: application/json" \
  -d '{"enterprise_id": "<your_enterprise_id>"}' \
  https://gw.mrkop.com/mcp/tools/enterprise_list_keys

常见问题

Q: MCP 连接失败？ A: 确认 API Key 有效且有企业权限。JWT 用户需要有企业成员身份。

Q: 工具调用返回"未找到企业上下文"？ A: 使用 API Key 认证时，Key 必须关联企业（enterprise_id 不为空）。

Q: 如何注册自定义 MCP 工具？ A: 联系平台管理员，可通过 MCP 网关接入外部 MCP 服务器。

MCP 集成指南

MrKop One API 支持 Model Context Protocol (MCP)，提供企业管理和 API 调用的 MCP 工具。

什么是 MCP

MCP 是 AI 模型与外部工具之间的标准化协议。通过 MCP，AI 助手可以：

管理企业 API 密钥
查询使用统计
代理发送 API 请求

连接方式

使用 API Key 认证（推荐）

json

{
  "mcpServers": {
    "mrkop": {
      "url": "https://gw.mrkop.com/mcp/sse",
      "headers": {
        "Authorization": "Bearer mrkop-xxxx"
      }
    }
  }
}

使用 JWT 认证

先通过 /v1/auth/login 获取 JWT Token，然后：

json

{
  "mcpServers": {
    "mrkop": {
      "url": "https://gw.mrkop.com/mcp/sse",
      "headers": {
        "Authorization": "Bearer <jwt_token>"
      }
    }
  }
}

可用 MCP 工具

企业密钥管理

工具	说明
`enterprise_list_keys`	列出企业所有 API 密钥
`enterprise_create_key`	创建企业 API 密钥
`enterprise_toggle_key`	启用/禁用密钥
`enterprise_delete_key`	删除密钥

企业信息查询

工具	说明
`enterprise_get_stats`	获取企业使用统计
`enterprise_list_members`	列出企业成员
`enterprise_get_wallet`	查询企业钱包余额
`enterprise_get_models`	获取可用模型列表

代理调用

工具	说明
`proxy_chat`	通过代理发送聊天请求

调试 MCP 连接

检查 MCP 工具列表：

bash

curl -H "Authorization: Bearer <api_key>" https://gw.mrkop.com/mcp/tools

调用单个工具：

bash

curl -X POST -H "Authorization: Bearer <api_key>" \
  -H "Content-Type: application/json" \
  -d '{"enterprise_id": "<your_enterprise_id>"}' \
  https://gw.mrkop.com/mcp/tools/enterprise_list_keys

常见问题

Q: MCP 连接失败？ A: 确认 API Key 有效且有企业权限。JWT 用户需要有企业成员身份。

Q: 工具调用返回"未找到企业上下文"？ A: 使用 API Key 认证时，Key 必须关联企业（enterprise_id 不为空）。

Q: 如何注册自定义 MCP 工具？ A: 联系平台管理员，可通过 MCP 网关接入外部 MCP 服务器。