API & MCP 访问

API & MCP 访问

Metricgram 提供公共 API 和 MCP 服务器，用于把你自己的工具、仪表板、自动化流程或 AI 客户端连接到账户可用的数据和操作。

API & MCP 访问适用于 Elite 套餐。如果你的账户不包含该功能，API & MCP 区域可能会显示为锁定，或提示升级套餐。

在哪里找到

在管理面板中打开 集成 > API & MCP。有权限的账户可以在这里创建 API token、查看有效 token、撤销 token，并查看当前套餐可用的技术参考。

Token 如何工作

• Token 属于你的 Metricgram 用户账户，不是某一个单独的群组。
• Token 可以访问该账户有权管理的群组和资源。
• Token 包含群组、成员、消息、自动化、订阅者、分析、支持工单、推荐和 MCP 等区域的权限。
• 部分 endpoint 只读取数据；其他 endpoint 可根据 token 权限创建、更新、审核或触发操作。
• Token 值只会在创建时显示一次。请安全保存。

认证和限制

API 请求使用 Authorization: Bearer mg_... header。默认限制是每个 token 每分钟 600 次请求，token 表单允许在应用支持的最小值和最大值之间选择。

如果 token 被撤销、账户失去 API 访问权限，或套餐不再包含 API & MCP，使用该 token 的请求会被拒绝。

最佳实践

• 为不同的外部工具创建单独的 token。
• 使用清晰的名称，方便识别每个 token 的用途。
• 撤销不再需要的 token。
• 不要在聊天、截图、工单或公开代码仓库中分享 token。