Claude Channels Telegram MCP

克劳德频道电报mcp

Claude Channels缺少出站层。将照片、文件（PDF、源代码）、键盘、Telegram Stars和TON工具添加到Claude code中——通过与Channels安全共存 CHANNELS_MODE （无投票冲突）。

这是什么

Claude Channels处理入站Telegram消息并提供 reply, react，以及 edit_message 对于出境。就是这样。任何更丰富的回应——照片、文件、按钮、付款发票——都需要这个工具包。

示例：Claude Code编码会话，结果发送到Telegram

为什么不直接使用任何Bot API MCP？

其他Bot API MCP服务器（TONresister/telegram-MCP、tsgram-MCP、ton-agent-kit）也提供出站工具，但它们都是轮询 getUpdates 连续不断地。将它们与克劳德频道一起运行 抵消冲突：消息被丢弃或传递两次。

CHANNELS_MODE=true 禁用此工具包中的所有轮询。渠道拥有入站；这个工具包处理出站。没有冲突。

主模式：CHANNELS_mode

CHANNELS_MODE (CHANNELS_MODE=true)--预期用例，以及Claude Channels：

• 入站：由渠道自动处理
• 出站：所有30个发送/TON工具可用
• 轮询已禁用--与通道没有偏移冲突

独立 （无频道）-也支持，不带频道插件：

• 入境： get_updates / get_pending_messages 可用的
• 所有33个可用工具

MCP工具--30在CHANNELS_MODE/33独立

电报（17个工具）

TON区块链（16个工具）

快速开始

git clone https://github.com/Masashi-Ono0611/claude-channels-telegram-mcp.git
cd claude-channels-telegram-mcp && bun install

配置MCP

添加到您的项目 .mcp.json:

{
  "mcpServers": {
    "telegram-toolkit": {
      "command": "bun",
      "args": ["run", "/path/to/claude-channels-telegram-mcp/src/index.ts"],
      "env": {
        "TELEGRAM_BOT_TOKEN": "",
        "TON_API_BASE_URL": "https://testnet.tonapi.io",
        "CHANNELS_MODE": "true"
      }
    }
  }
}

操作模式

集 CHANNELS_MODE=true 在你的 .mcp.json env（如上所示，已包含在示例中）。

环境变量

# Required
TELEGRAM_BOT_TOKEN=
CHANNELS_MODE=true   # set to true when using alongside Claude Channels plugin

# TON network (auto-detects testnet/mainnet from URL)
TON_API_BASE_URL=https://testnet.tonapi.io    # testnet (default)
TON_API_BASE_URL=https://tonapi.io            # mainnet
TON_API_KEY=               # increases rate limits

# Agent wallet (required for send_ton / transfer_jetton)
AGENT_MNEMONIC_PATH=/path/to/mnemonic.txt
TONCENTER_ENDPOINT=      # auto-derived from TON_API_BASE_URL
TONCENTER_API_KEY=

如果未设置TON环境变量，TON工具将返回“未配置”错误。电报工具无论如何都能工作。

建筑

Claude Code
  │
  ├── Claude Channels (built-in plugin)
  │   └── reply, react, edit_message (inbound + outbound messaging)
  │
  └── claude-channels-telegram-mcp (this MCP server)
      ├── Telegram: send, keyboards, media, commands, invoice, callbacks, polling
      └── TON: balance, price, swap, transfer, payment links, tx history, jetton, wallet connect

关键设计： 在CHANNELS_MODE中，只有仅发送API处于活动状态，与CHANNELS没有轮询冲突。在独立模式下， get_updates + send_message + answer_callback_query 提供完整的接收-响应循环。TON读取工具使用tonapi.io；编写工具使用TonCenter RPC。从以下位置自动检测网络（测试网/主网） TON_API_BASE_URL.

完整的响应管道（独立）

User presses inline button → get_updates → callback_query received
→ answer_callback_query("Processing...") → send_invoice(Stars)
→ User pays → pre_checkout_query received
→ answer_pre_checkout_query(ok=true) → send_message("Payment complete!")

支付链接流（CHANNELS_MODE或独立）

generate_ton_payment_link + send_keyboard 启用用户支付流而不暴露代理钱包：

Claude → generate_ton_payment_link → send_keyboard with URL button
User taps button → TonKeeper / any TON wallet opens → user signs & sends
Claude → get_transactions → verify payment received

TON Connect Flow（用户钱包）

generate_tonconnect_link + send_keyboard 连接用户自己的钱包（TonKeeper），而不暴露任何代理私钥：

Claude → generate_tonconnect_link → { session_id, tonkeeper_link }
Claude → send_keyboard with URL button (tonkeeper_link)
User taps → TonKeeper opens → user approves connection
Claude → check_tonconnect_session(session_id) → { status: "connected", address }
Claude → request_ton_payment(session_id, to, "0.5") → user approves in TonKeeper → { boc }
Claude → disconnect_wallet(session_id)

会话状态持久化为 ~/.ctt/sessions/.json，因此连接在MCP呼叫中仍然存在。

CHANNELS_MODE：什么有效，什么无效

在CHANNELS_MODE中(CHANNELS_MODE=true)，这三个轮询工具在两个位置都被禁用 ListTools 和 CallTool 级别，以防止与Channels插件的偏移冲突。

⚠️ reply 对比 send_message --不可互换

使用频道 reply 对于所有会话响应。使用 send_message 仅用于主动或定时发送（例如通知）。

⚠️ CHANNELS_MODE中的回拨按钮不起作用

回拨按钮(callback_data)要求 get_updates 从Telegram接收回拨事件。由于CHANNELS_MODE中禁用了轮询，因此回调数据永远不会传递给Claude。

在CHANNELS_MODE中，对所有交互元素（支付链接、TonKeeper连接、外部页面）使用URL按钮。

已测试

许可证

麻省理工学院