MCP Telegram

Name: MCP Telegram
Author: mcp-telegram

mcp-telegram

开始使用源码仓库官网与文档

Connects a personal Telegram account over MTProto to read chats, search messages, download media and manage contacts.

接入配置

选择客户端，复制配置，再按项目文档补齐环境变量。

一键添加到 Cursor 一键添加到 VS Code

本地运行

claude mcp add telegram-telegram --env TELEGRAM_API_ID='<TELEGRAM_API_ID>' --env TELEGRAM_API_HASH='<TELEGRAM_API_HASH>' -- npx -y @overpod/mcp-telegram

~/.codex/config.toml

[mcp_servers.telegram-telegram]
command = "npx"
args = ["-y", "@overpod/mcp-telegram"]
env = { TELEGRAM_API_ID = "<TELEGRAM_API_ID>", TELEGRAM_API_HASH = "<TELEGRAM_API_HASH>" }

# codex mcp add telegram-telegram --env TELEGRAM_API_ID='<TELEGRAM_API_ID>' --env TELEGRAM_API_HASH='<TELEGRAM_API_HASH>' -- npx -y @overpod/mcp-telegram

~/.cursor/mcp.json

{
  "mcpServers": {
    "telegram-telegram": {
      "command": "npx",
      "args": [
        "-y",
        "@overpod/mcp-telegram"
      ],
      "env": {
        "TELEGRAM_API_ID": "<TELEGRAM_API_ID>",
        "TELEGRAM_API_HASH": "<TELEGRAM_API_HASH>"
      }
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "telegram-telegram": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@overpod/mcp-telegram"
      ],
      "env": {
        "TELEGRAM_API_ID": "<TELEGRAM_API_ID>",
        "TELEGRAM_API_HASH": "<TELEGRAM_API_HASH>"
      }
    }
  }
}

~/.gemini/settings.json

{
  "mcpServers": {
    "telegram-telegram": {
      "command": "npx",
      "args": [
        "-y",
        "@overpod/mcp-telegram"
      ],
      "env": {
        "TELEGRAM_API_ID": "<TELEGRAM_API_ID>",
        "TELEGRAM_API_HASH": "<TELEGRAM_API_HASH>"
      }
    }
  }
}

claude_desktop_config.json

{
  "mcpServers": {
    "telegram-telegram": {
      "command": "npx",
      "args": [
        "-y",
        "@overpod/mcp-telegram"
      ],
      "env": {
        "TELEGRAM_API_ID": "<TELEGRAM_API_ID>",
        "TELEGRAM_API_HASH": "<TELEGRAM_API_HASH>"
      }
    }
  }
}

.trae/mcp.json

{
  "mcpServers": {
    "telegram-telegram": {
      "command": "npx",
      "args": [
        "-y",
        "@overpod/mcp-telegram"
      ],
      "env": {
        "TELEGRAM_API_ID": "<TELEGRAM_API_ID>",
        "TELEGRAM_API_HASH": "<TELEGRAM_API_HASH>"
      }
    }
  }
}

远程托管

claude mcp add --transport http telegram-telegram https://mcp.mcp-telegram.com/mcp

~/.codex/config.toml

[mcp_servers.telegram-telegram]
url = "https://mcp.mcp-telegram.com/mcp"

# codex mcp add telegram-telegram --url https://mcp.mcp-telegram.com/mcp

~/.cursor/mcp.json

{
  "mcpServers": {
    "telegram-telegram": {
      "url": "https://mcp.mcp-telegram.com/mcp"
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "telegram-telegram": {
      "type": "http",
      "url": "https://mcp.mcp-telegram.com/mcp"
    }
  }
}

~/.gemini/settings.json

{
  "mcpServers": {
    "telegram-telegram": {
      "httpUrl": "https://mcp.mcp-telegram.com/mcp"
    }
  }
}

claude_desktop_config.json · Customize › Connectors › Add custom connector

{
  "mcpServers": {
    "telegram-telegram": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.mcp-telegram.com/mcp"
      ]
    }
  }
}

.trae/mcp.json

{
  "mcpServers": {
    "telegram-telegram": {
      "url": "https://mcp.mcp-telegram.com/mcp"
    }
  }
}

需要的环境变量

TELEGRAM_API_ID
TELEGRAM_API_HASH

把占位值换成你自己的密钥；不要把密钥提交到代码仓库。

接入配置

本地运行

远程托管

需要的环境变量

相关推荐