Saltar para o conteúdo
Verificado

Ligar um cliente de IA por MCP

Adicione o Xuda como servidor MCP remoto ao Claude, ao Cursor ou a qualquer outro cliente compatível com MCP.

Esta página trata do lado do cliente: pôr o Claude, o Cursor ou qualquer outro cliente que fale MCP a comunicar com a sua conta Xuda. Para o próprio protocolo, a nomenclatura das ferramentas, o ciclo de vida da sessão e o formato dos erros, veja MCP.

O que precisa

Uma só coisa: uma chave de API. Crie uma na área Programadores da conta (o acesso total alcança tudo o que o proprietário da chave pode, o acesso personalizado alcança apenas um conjunto permitido de métodos), veja Autenticação. Não há uma credencial MCP separada, a mesma chave funciona em REST simples em /cpi/<method> e em MCP.

Um endpoint para todas as chaves

Todas as chaves de API da conta, e a chave emitida automaticamente para cada caixa Full Stack VPS, apontam para o mesmo endereço: https://xuda.ai/mcp. Uma chave Full Stack VPS expõe adicionalmente as ferramentas de plugin instaladas dessa caixa a par dos métodos do ecossistema, veja Full Stack VPS.

Ligue um cliente

claude mcp add --transport http xuda https://xuda.ai/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"
{
  "mcpServers": {
    "xuda": {
      "url": "https://xuda.ai/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}
{
  "mcpServers": {
    "xuda": {
      "type": "http",
      "url": "https://xuda.ai/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

O Cursor lê o seu snippet em .cursor/mcp.json (projeto) ou nas suas definições globais de MCP. O Claude Desktop e o claude.ai adicionam um servidor remoto em Definições, em Conectores: um nome, o URL e o mesmo cabeçalho Authorization. Qualquer outro cliente MCP precisa apenas dos mesmos dois dados: um endpoint HTTP em streaming em https://xuda.ai/mcp e a chave em cada pedido como Authorization: Bearer YOUR_API_KEY.

O dashboard escreve isto por si

A página Programadores, Chaves de API de cada conta tem um cartão Connect por baixo da lista de chaves. O seu seletor de formato alterna um bloco entre .env, Next.js, MCP, cURL, Node.js e PHP, cada um já preenchido com o endpoint e a primeira chave da lista, que o cabeçalho do bloco nomeia. O formato .env leva XUDA_MCP_URL ao lado da base REST e da chave, e o formato MCP é o comando do Claude Code acima. A chave aparece mascarada até a revelar; Copiar leva sempre o valor real.

O que o agente recebe ao ligar

O primeiro pedido numa nova ligação é uma chamada MCP initialize. A resposta do Xuda traz um campo instructions construído a partir do guia LLM do Studio, o mesmo modelo de documentos de prog, a mesma referência de atributos xu-* e as mesmas regras de fluxo de trabalho tratados nessa página, fundidos a partir dos registos ativos da própria plataforma, para que nunca possa descrever uma regra que o validador implementado não aplique realmente. A maioria dos clientes MCP encaminha o instructions diretamente para o contexto do modelo, por isso o agente já sabe como se constrói um prog do Studio antes da sua primeira chamada a uma ferramenta, sem necessidade de um briefing separado.

Vale a pena chamar duas ferramentas diretamente em vez de depender do que chegou na altura da ligação: get_studio_guide volta a ler qualquer tópico a pedido (components, tables, programs, javascript, attributes, anatomy, gotchas), e get_prog_examples devolve progs de exemplo funcionais e selecionados para servirem de modelo a uma construção.

Um endpoint dedicado para um programa de API

Os métodos acima são o catálogo inteiro da conta por trás de uma chave. Quando quer que um sistema externo alcance exatamente um endpoint de um projeto, implemente-o: Implementar > Implementações > Servidor lista o Servidor MCP a par de Cron, Api, Node e Emitter. O seu passo Launch Settings escolhe um dos programas api do próprio projeto como alvo, e depois os passos habituais de centro de dados, nível de desempenho e nomenclatura enviam-no como o seu próprio endpoint. Veja A sua primeira implementação para as partes partilhadas desse assistente, e API para saber o que é um programa api.

Tipo de implementação beta

O mcp está hoje listado entre os tipos de implementação beta da plataforma, a par de router, android e emitter.