Servers do cliente
Conectar um MCP server próprio, o diálogo de conexão, a autenticação por token Xokepoint e o exemplo de código para o server.
Um server do cliente é um MCP server que a própria empresa escreveu: um RAG interno, uma ponte para um sistema legado, um server de issues. Ele pode confiar no Xokepoint e saber, em cada chamada, quem é a pessoa e qual agente está agindo.
A lista
Os servers ficam em Access › Integrations › Custom MCPs:
| Coluna | O que mostra |
|---|---|
| Connection | Nome, tipo e transporte detectado: "Custom MCP · streamable-http" |
| Managed tools | Quantas tools estão sob gestão, e Review required quando o server mudou e alguma tool espera revisão |
| Status | Enabled ou desabilitado |
| Actions | Edit & discover e Disable |
Find a connection filtra por nome ou endpoint. Clicar na linha abre os detalhes do server.
Conectar
Connect custom MCP abre o diálogo:
- Server name: o nome que aparece no Admin, nos agentes e nas decisões.
- MCP endpoint: a URL HTTP do server.
- Transport: Streamable HTTP ou HTTP+SSE. O transporte é confirmado na descoberta.
stdionão é suportado, porque o Xokepoint precisa alcançar o server pela rede. - Discover tools chama o server e abre a revisão das tools descobertas.
Autenticação: token Xokepoint
A autenticação de um server do cliente é sempre o token Xokepoint. Não há senha nem bearer token para cadastrar. O diálogo e os detalhes mostram os três valores que o server precisa conhecer, cada um com botão de copiar:
| Valor | Para quê |
|---|---|
| Issuer | O emissor dos tokens que o server deve aceitar, um por workspace e ambiente |
| JWKS | A URL das chaves públicas. O server lê a URL; as chaves giram, então não se copia a chave |
| Audience | O endpoint do próprio server. Um token emitido para outro server é recusado |
Em cada chamada permitida, o server recebe um token de 60 segundos só para ele, com sub (a pessoa ou o serviço) e act.sub (o agente).
Exemplo para o server
Os detalhes do server trazem Example: FastMCP, com os valores do ambiente já preenchidos e Copy example:
O exemplo configura o JWTVerifier com o JWKS, o issuer e a audience, e mostra como ler sub e act.sub dentro de uma tool. Validar o token Xokepoint explica cada verificação.