Channel.io

Herramientas MCP de Channel.io (mcp-channel-talk, mcp-channel-io)

Resumen

Herramienta no oficial de MCP para Channel.io.

Este proyecto utiliza la OPEN API de Channel.io para integrarse con el Protocolo de Contexto de Modelos (MCP). De esta manera, los asistentes de IA pueden acceder y utilizar la información de chat de Channel.io.

Descripción

Funciones implementadas

1. Consulta de lista de chats
2. Consulta de lista de mensajes de cada chat (solicitudes en paralelo)

Condiciones de consulta

• Consulta por estado del chat, etiqueta, nombre de administrador y prioridad (importancia)
• Consulta por nombre, correo electrónico, empresa y número de teléfono del solicitante
• Al consultar la lista de mensajes de un chat, solo se obtienen hasta los 10 mensajes más recientes

Detalles

• Solo se proporciona una parte de la OPEN API de Channel.io
• Cuando la respuesta es grande, el funcionamiento de la IA suele verse afectado, por lo que se reduce el tamaño de la respuesta mediante un mapeo intermedio. Por lo tanto, la respuesta final se maneja solo con la información necesaria.

Uso desde un cliente MCP

Cuando se use desde un cliente MCP (como Claude Desktop), configúrelo de la siguiente manera:

Usando npx (recomendado)

{
  "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
      ]
    }
  }
}

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

Configuración de desarrollo local

Instalación

# 패키지 설치
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. Ejecutar con argumentos de CLI (recomendado)

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

2. Desarrollo con variables de entorno

Cree el archivo .env en la raíz del proyecto y configure las claves API necesarias:

CHANNEL_TALK_X_ACCESS_KEY=your_access_key_here
CHANNEL_TALK_X_ACCESS_SECRET=your_access_secret_here

Luego ejecute:

npm start

O:

node build/index.js

Entorno

Requisitos previos

• Node.js 18 o superior
• npm o yarn

Stack tecnológico

• TypeScript
• Model Context Protocol SDK (@modelcontextprotocol/sdk)
• Zod (validación)
• dotenv (gestión de variables de entorno)

Obtener API Keys

1. Inicie sesión en la Consola de desarrolladores de Channel.io
2. Cree una aplicación y obtenga sus API Keys
3. Guarde de forma segura su Access Key y Secret Key

Aviso de seguridad

• No incruste claves API en el código
• No suba el archivo .env al repositorio (ya está incluido en .gitignore)
• En entornos de producción, use argumentos de CLI o variables de entorno

Documentación de referencia

• Documentación de la OPEN API de Channel.io

• Guía de la OPEN API de Channel.io: lista de chats

• Guía de la OPEN API de Channel.io: lista de mensajes de chat

• Guía de MCP

• Guía de MCP: herramientas

Licencia

ISC

Contribuciones

Siempre son bienvenidos los problemas y solicitudes de incorporación de cambios.