Communicate

Conéctate con MCP

Conecta un cliente MCP al endpoint HTTP Streamable autenticado de Communicate.

El endpoint remoto de MCP es:

https://app.communicate.so/mcp

Expone una herramienta de solo lectura:

Herramienta	Alcance	Resultado
communicate_list_agents	agents:read	Agentes en el espacio de trabajo autenticado

Crea un token de acceso MCP

Crea una clave API con agents:read, luego intercambia su ID de cliente y el secreto de un solo uso ck_ por un token vinculado al recurso MCP.

export COMMUNICATE_CLIENT_ID="your_key_id"
export COMMUNICATE_CLIENT_SECRET="ck_your_secret"

export COMMUNICATE_MCP_TOKEN="$(curl -sS \
  -u "$COMMUNICATE_CLIENT_ID:$COMMUNICATE_CLIENT_SECRET" \
  https://app.communicate.so/api/v1/oauth/token \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "grant_type=client_credentials" \
  -d "scope=agents%3Aread" \
  -d "resource=https%3A%2F%2Fapp.communicate.so%2Fmcp" \
  | jq -r '.access_token')"

El token caduca después de una hora. Solicita un nuevo token antes de reconectarte después de la caducidad.

Configura tu cliente

Usa HTTP Streamable y envía el token como credencial de portador:

{
  "mcpServers": {
    "communicate": {
      "url": "https://app.communicate.so/mcp",
      "headers": {
        "Authorization": "Bearer ${COMMUNICATE_MCP_TOKEN}"
      }
    }
  }
}

Para Codex, usa la configuración equivalente de token de portador respaldada por entorno:

[mcp_servers.communicate]
url = "https://app.communicate.so/mcp"
bearer_token_env_var = "COMMUNICATE_MCP_TOKEN"

Advertencia

No coloques el secreto del cliente o el token de portador directamente en un archivo de configuración confirmado. El endpoint no acepta secretos ck_ de larga duración.

Descubrimiento OAuth

Los clientes MCP pueden descubrir el contrato de autenticación desde:

https://app.communicate.so/.well-known/oauth-protected-resource/mcp
https://app.communicate.so/.well-known/oauth-authorization-server/api/v1

Los tokens MCP aceptan solo agents:read. Usa un token REST separado con chat:write para conversaciones de agentes.

Esta documentación está construida y alojada en Mintlify, una plataforma de documentación para desarrolladores.