API & MCP 访问

API & MCP 访问

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

MCP 服务器适用于 所有付费套餐，14 天免费试用期间也可使用。AI 客户端可以通过 OAuth（粘贴服务器 URL 并批准访问）或 API token 连接。REST API 需要 Elite 访问权限。如果你的账户不包含该功能，API 区域可能会显示为锁定，或提示升级套餐。

在哪里找到

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

Token 如何工作

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

通过 MCP 使用 Telegram Bot API

MCP 服务器还提供按群组隔离的 Telegram Bot API，AI 智能体可以通过 Metricgram 机器人或您的自定义机器人在您的群组中执行操作。

• 使用 telegram_api_methods 列出您的 Token 可以调用的方法，并使用 telegram_bot_api 以官方 Bot API 参数调用其中任意方法。
• 类型化工具覆盖日常工作：send_telegram_message、send_telegram_media、send_telegram_poll、pin_telegram_message、manage_forum_topic、create_telegram_invite_link 等。
• 目标聊天始终是您自己的群组之一。您无需传入 chat_id，Metricgram 会根据 group_id 自动推导。
• Telegram 操作使用独立的权限范围：telegram:read、telegram:write、telegram:moderate 和 telegram:admin。在这些权限范围推出之前创建的 Token 需要重新创建才能使用它们。
• 媒体必须是公开的 HTTPS URL 或 Telegram file_id，内联按钮只能打开 URL 或复制文本。
• 写入类工具支持可选的 idempotency_key，重试的调用不会重复执行。

认证和限制

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

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

最佳实践

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