Conectar outro cliente MCP

O Senso MCP segue o padrão MCP: seu site não fica limitado a um único assistente. Qualquer cliente compatível pode se conectar a ele da mesma forma.

Cliente MCP genérico

Um cliente MCP genérico se comunica com o servidor via HTTP e se autentica por meio do OAuth. Graças aos documentos de descoberta .well-known, ele configura a autenticação automaticamente usando apenas a URL do servidor.

Parâmetros obrigatórios

• a URL do servidor MCP: https://seu-site.tld/api/index.php/v1/mcp;
• o transporte: HTTP streamable (o transporte SSE, mais antigo, não é utilizado);
• a autenticação: OAuth, descoberta automaticamente (não é necessário informar nada), ou um token de API do Joomla (veja abaixo).

Exemplo de configuração

A maioria dos clientes aceita uma configuração deste tipo:

{
  "mcpServers": {
    "meu-site-joomla": {
      "url": "https://seu-site.tld/api/index.php/v1/mcp"
    }
  }
}

Consulte a documentação do seu cliente para saber onde exatamente essa configuração deve ser definida.

Token de API ou OAuth?

Há dois modos de autenticação, destinados a usos diferentes:

• OAuth — para assistentes interativos (Claude, ChatGPT, Copilot…). O usuário se identifica no seu site, escolhe os escopos que deseja conceder e pode revogar a conexão a qualquer momento. Não é necessário copiar nenhum segredo.
• Token de API do Joomla — para automações e servidores (n8n, Make, Zapier, scripts). O token é criado no perfil do usuário, na aba Token de API, e enviado no cabeçalho Authorization: Bearer <token>. A conta deve ter a permissão API Login. Um token dá acesso a todas as ferramentas autorizadas pela ACL da conta, sem uma tela de consentimento: reserve-o para uma conta dedicada e aplique o princípio do menor privilégio.

Chamada direta em JSON-RPC

O MCP nada mais é do que JSON-RPC sobre HTTP. Uma ferramenta que não disponha de um cliente MCP, ou um simples módulo « HTTP Request », pode chamar o servidor diretamente. Para listar as ferramentas disponíveis:

curl -s -X POST "https://seu-site.tld/api/index.php/v1/mcp" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Para chamar uma ferramenta, neste caso a criação de um artigo:

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "create_article",
    "arguments": {
      "title": "Meu artigo",
      "catid": 8,
      "body": "<p>Texto do artigo.</p>"
    }
  }
}

A resposta de tools/list descreve cada ferramenta e o esquema JSON de seus argumentos: essa é a referência a ser consultada para construir suas chamadas. As mesmas regras se aplicam ao uso com um assistente: controles do site, ACL da conta e modo somente leitura.