Communicate

Conecte-se com MCP

Conecte um cliente MCP ao endpoint autenticado Streamable HTTP do Communicate.

O endpoint MCP remoto é:

https://app.communicate.so/mcp

Ele expõe uma ferramenta somente leitura:

Ferramenta	Escopo	Resultado
communicate_list_agents	agents:read	Agentes no workspace autenticado

Criar um token de acesso MCP

Crie uma chave de API com agents:read, depois troque seu client ID e o segredo de uso único ck_ por um token vinculado ao 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')"

O token expira após uma hora. Solicite um novo token antes de reconectar após a expiração.

Configurar seu cliente

Use Streamable HTTP e envie o token como credencial de portador:

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

Para Codex, use a configuração equivalente de token de portador baseada em ambiente:

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

Aviso

Não coloque o segredo do cliente ou o token de portador diretamente em um arquivo de configuração versionado. O endpoint não aceita segredos ck_ de longa duração.

Descoberta OAuth

Clientes MCP podem descobrir o contrato de autenticação em:

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

Tokens MCP aceitam apenas agents:read. Use um token REST separado com chat:write para conversas com agentes.

Esta documentação é construída e hospedada no Mintlify, uma plataforma de documentação para desenvolvedores.