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.
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
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.
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.
O mcp está hoje listado entre os tipos de implementação beta da plataforma, a par de router, android e
emitter.