Channel Talk MCP Server

채널톡 MCP 도구 （mcp频道通话、mcp频道输入输出）

概述

非正式渠道Talk MCP工具。

这个项目 频道Talk 利用OPEN API与Model Context Protocol（MCP）集成的工具。 这使AI助手可以访问和利用ChannelTalk中的聊天信息。


说明

实施功能

1. 查看聊天列表
2. 查看每个聊天消息列表（并行请求）

查询条件

• 按聊天状态、标签、管理员姓名、优先级（重要度）进行查看
• 通过询问者的姓名、电子邮件、公司名称和电话号码查询
• 查看聊天信息列表时，最多查看10条最新信息

详细信息

• 仅提供部分ChannelTalk OPEN_API
• 当响应大小较大时，ai操作通常不流畅，因此通过中间map操作减少响应大小。因此，只处理最终响应中所需的信息。

用于MCP客户端

在MCP客户端（Claude Desktop等）上使用时，请设置以下设置：

使用npx（recommended）

{
  "mcpServers": {
    "mcp-channel-io": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-channel-io",
        "--",
        "--access-key",
        "YOUR_ACCESS_KEY",
        "--secret-key",
        "YOUR_SECRET_KEY",
        "--ssl-off" // NODE_TLS_REJECT_UNAUTHORIZED
      ]
    }
  }
}

smithery 사용

{
  "mcpServers": {
    "channel-io": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli@latest",
        "run",
        "@scarfunk/mcp-channel-io",
        "--key",
        "your-smithery-key...",
        "--profile",
        "your-profile-name..."
      ]
    }
  }
}

本地开发设置

设置

# 패키지 설치
npm install

# 빌드
npm run build

// 로컬서버로 .cursor/mcp.json 에 넣고 싶으면 아래 처럼 추가.
{
  "mcpServers": {
    "channel-io": {
      "command": "node",
      "args": [
        "/path/to/YOUR-PROJECT-DIR/build/index.js",
        "--access-key",
        "YOUR_ACCESS_KEY...",
        "--secret-key",
        "YOUR_SECRET_KEY..."
      ]
    }
  }
}

1.作为CLI参数运行（推荐）

# 빌드 후 실행
npm run build
node build/index.js --access-key YOUR_ACCESS_KEY --secret-key YOUR_SECRET_KEY

2.开发为环境变量

在项目根目录中 .env 创建文件并设置所需的API密钥：

CHANNEL_TALK_X_ACCESS_KEY=your_access_key_here
CHANNEL_TALK_X_ACCESS_SECRET=your_access_secret_here

之后运行

npm start

或者

node build/index.js

环境

必备条件

• Node.js 18或更高版本
• npm或yarn

技术堆栈

• TypeScript
• 模型上下文协议SDK（@modelcontextprotocol/SDK）
• 验证（Zod）
• dotenv（管理环境变量）

获取API密钥

1. ChannelTalk开发者控制台登录到
2. 创建应用程序并获得API密钥
3. 确保Access Key和Secret Key的安全

安全注意事项

• 不要在代码中硬编码API密钥
• .env 不要将文件提交到git（已包含在.gitignore中）
• 在生产环境中使用CLI参数或环境变量

参考文档

• ChannelTalk OPEN API文档

• ChannelTalk OPEN API指南聊天列表

• ChannelTalk OPEN API指南聊天消息列表

• MCP指南

• MCP指南工具

许可证

国际协调委员会

贡献

无论何时都欢迎热点和完整的请求。