Comece aqui · MCP

Servidor MCP da documentação, no ar.

no ar Esta instância do portal serve o servidor MCP uy3-docs v1.0.0 em POST http://developers.uy3.com.br/mcp. Se você está lendo esta página, o processo que responde por ela é o mesmo que responde pelo MCP — não há segundo serviço para subir.

Ferramentas

Recursos

Prompts

Somente leitura de documentação. Nenhuma ferramenta chama a API da UY3, recebe credencial ou tem efeito. O que sai daqui é a mesma documentação que este portal publica, pela mesma curadoria — e o retorno de qualquer ferramenta é dado, nunca instrução. Passo a passo para integradores em Integração via MCP.

1. Conectar o seu cliente

O endereço abaixo já está preenchido com o host desta instância. A maioria dos clientes MCP usa este formato de configuração; não há chave, senha nem cabeçalho de autenticação.

{
  "mcpServers": {
    "uy3-docs": {
      "type": "http",
      "url": "http://developers.uy3.com.br/mcp"
    }
  }
}

Baixar .mcp.json — salve na raiz do seu projeto. O bloco acima também tem botão Copiar.

2. Conferir sem nenhum cliente MCP

Duas chamadas resolvem. A primeira é um GET comum e devolve este mesmo estado em JSON — é o que um health check deve usar. A segunda é o protocolo de verdade: lista as ferramentas pelo JSON-RPC, como um cliente MCP faria.

curl -s http://developers.uy3.com.br/mcp/status.json

curl -s -X POST http://developers.uy3.com.br/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Validação completa, com um comando. No repositório do portal, dotnet run --project Tools/McpProbe -- http://developers.uy3.com.br/mcp abre uma sessão MCP de verdade contra este endereço, chama as ferramentas, lê um recurso, pega o prompt e confere que o servidor no ar expõe exatamente o inventário do código. Sai com 0 quando tudo passa.

3. O que este servidor está publicando agora

Números lidos do mesmo catálogo que as páginas do portal usam — não são uma cópia.


Ferramentas	13
Recursos	5
Prompts	3
Páginas de guia publicadas	25
Módulos de produto com contexto próprio	2
Contratos OpenAPI carregados	3
Endpoints visíveis na Referência curada	264 de 502
Tipos de operação de crédito ativos	10

Ferramentas

Chamadas pelo cliente com tools/call. O argumento PortalCatalog não aparece em nenhum schema: ele vem da injeção de dependência do portal, não de quem chama.

Ferramenta	Argumentos	O que devolve
`uy3_buscar_documentacao`	`consulta`, `modulo` (opc.), `escopo` (opc.)	Busca de texto em TUDO o que a UY3 publica: as páginas de guia escritas à mão e, por padrão, também as descrições do contrato (endpoints, campos e valores de enum).
`uy3_buscar_endpoints`	`consulta`, `api` (opc.)	Procura um endpoint pelo que ele FAZ, em vez de listar todos e escolher no olho.
`uy3_campo`	`campo`, `api` (opc.)	O que é UM campo do contrato, pelo nome: tipo, se é obrigatório, os VALORES ACEITOS quando é enum, a descrição, e em quais endpoints ele aparece.
`uy3_catalogo_mcp`	—	Descreve este servidor: o que cada ferramenta faz, de qual fonte de verdade ela deriva, e o que o servidor NÃO faz.
`uy3_contexto_modulo`	`modulo`, `parte` (opc.)	TODA a documentação de um módulo de produto em um texto só, na ordem de execução das etapas.
`uy3_endpoint_por_rota`	`metodo`, `rota`	Resolve um par MÉTODO + ROTA para o endpoint publicado correspondente, de forma determinística.
`uy3_ler_guia`	`id`	O Markdown completo de UMA página de guia, pelo id.
`uy3_listar_endpoints`	`api`, `secao` (opc.)	Lista os endpoints VISÍVEIS da Referência curada de uma API da UY3, agrupados pelas etapas do fluxo de integração.
`uy3_listar_modulos`	—	A navegação publicada: seções, módulos de produto e as páginas de cada módulo NA ORDEM em que o negócio permite executá-las.
`uy3_montar_requisicao`	`api`, `opId`, `dados` (opc.)	CONFERE um payload contra o contrato antes de qualquer chamada: campo obrigatório faltando, valor fora dos aceitos, campo que não existe no endpoint — e, dentro dos objetos, campo que não pertence ao TIPO declarado.
`uy3_pendencias`	—	Divergências CONHECIDAS entre o contrato e a documentação curada, ainda sem decisão.
`uy3_referencia_endpoint`	`api`, `opId`	Devolve a documentação campo a campo de UM endpoint: parâmetros, corpo da requisição com tabela de campos e exemplo, resposta, códigos de retorno e cURL.
`uy3_tipos_operacao`	`tipo` (opc.)	Tipos de operação de crédito (modelo de cálculo, valor de amortizationType) derivados do contrato.

Recursos

Endereçáveis por URI, para o cliente anexar ao contexto sem gastar uma chamada de ferramenta (resources/read).

URI	Argumentos	O que devolve
`uy3://collection/{slug}`	`slug`	A collection do Postman de um módulo, com as requisições na ordem do fluxo e os placeholders de URL base e token já declarados.
`uy3://contexto/{modulo}`	`modulo`	Toda a documentação de UM módulo de produto, na ordem de execução das etapas.
`uy3://guia/{id}`	`id`	Uma página de guia pelo id, como em uy3_listar_modulos.
`uy3://llms.txt`	—	Toda a documentação de guias publicada em um arquivo, na ordem da navegação.
`uy3://referencia/{api}`	`api`	A Referência curada de uma API (creditapi, billingapi, bankingapi) campo a campo, só com os endpoints visíveis.

Prompts

Roteiros prontos, montados da árvore de navegação. É o que nem um arquivo consolidado nem um contrato OpenAPI entregam: a ordem em que o negócio permite executar as etapas.

Prompt	Argumentos	O que monta
`uy3_integrar_modulo`	`modulo`	Monta o roteiro de integração de um produto da UY3 na ordem correta das etapas, com as ferramentas a chamar em cada uma e os erros que mais aparecem em código gerado por assistente.
`uy3_revisar_guia`	`guia`	Monta o roteiro de auditoria de uma página de guia contra o contrato: nomes de campo, valores de enum, obrigatoriedade e rotas.
`uy3_validar_payload`	`api`, `opId`	Monta o roteiro de conferência de uma requisição contra o contrato da UY3, campo a campo, antes de o código ser escrito.

O que este servidor não faz

Não chama a API da UY3. Nenhuma ferramenta cria, altera, envia para aprovação ou cancela nada.
Não recebe, guarda nem repassa credencial. Não envie token, chave ou dado pessoal em argumento de ferramenta — nenhuma delas precisa disso, e nenhuma usa.
Não entrega o que a curadoria esconde: página fora da navegação e operação fora da Referência recebem a mesma recusa que uma inexistente.

Se não estiver funcionando

Sintoma	Causa provável
`405` ao abrir o endereço do MCP no navegador	Esperado. O endpoint é `POST`; navegador manda `GET`. É esta página que responde ao `GET`.
Conexão recusada	O portal não está no ar neste endereço. Suba com `dotnet run` e confira a porta na linha Now listening on.
`406 Not Acceptable`	Falta o cabeçalho `Accept: application/json, text/event-stream` na requisição.
O cliente conecta, mas não lista ferramenta nenhuma	Cliente configurado como `sse` ou `stdio`. O transporte aqui é HTTP (`"type": "http"`).
Ferramenta que existe no código não aparece aqui	O processo no ar é de um build anterior. `dotnet build` e suba de novo — o `Tools/McpProbe` acusa exatamente essa divergência.