O que é o servidor MCP
O Model Context Protocol permite que um assistente consulte ferramentas externas durante uma conversa. Com a FonteIA, ele pode descobrir canais e fontes, buscar evidências tributárias e consultar documentos trabalhistas conforme as ferramentas disponíveis. Jurisprudências ainda não está habilitada para consulta.
O assistente conectado decide quando chamar as ferramentas. A busca e a leitura retornam documentos e evidências. A ferramenta de resposta está sujeita aos recursos de cada canal; a síntese jurídica trabalhista não está habilitada. Preserve a diferença entre texto oficial, resultado documental e análise produzida pelo assistente.
Endpoint e transporte
https://api.fonteia.ai/mcpTransporte: Streamable HTTP, com mensagens JSON-RPC 2.0. As ferramentas são chamadas por POST. O cliente negocia a versão do protocolo durante initialize.
O cliente deve aceitar application/json e text/event-stream e enviar MCP-Protocol-Version com a versão negociada. O servidor opera sem sessões persistentes; o canal GET de eventos não está disponível e retorna 405.
Autenticação e autorização
Clientes compatíveis podem utilizar OAuth 2.0, registro dinâmico de cliente e Authorization Code com PKCE. Autorize sua conta e confira os acessos solicitados. O token é enviado como Authorization: Bearer nas requisições MCP.
O serviço publica metadados em /.well-known/oauth-authorization-server e /.well-known/oauth-protected-resource, na base https://api.fonteia.ai.
As ferramentas exigem autorização válida. Ler esta documentação não cria chaves nem autoriza uma conexão.
Ferramentas da FonteIA
list_source_groups
Consulte list_research_channels para descobrir os canais e a disponibilidade atual. list_source_groups lista os grupos de fontes do canal selecionado e seus estados. O parâmetro include_planned tem padrão true; envie false para excluir os grupos planejados. Um grupo planejado não representa conteúdo disponível para consulta.
search_evidence
Busca trechos oficiais relacionados à consulta, preservando referências e URLs disponíveis.
| Parâmetro | Uso |
|---|---|
query | Consulta textual obrigatória. |
research_channel | Área selecionada: tributario_fiscal ou relacoes_trabalhistas quando disponíveis. jurisprudencias ainda não está habilitado. |
limit | Quantidade solicitada; respeite o schema de cada ferramenta. |
source_groups | Lista opcional de identificadores obtidos no catálogo. Omita para pesquisar nos grupos ativos do canal selecionado. |
Use consultas concretas e os identificadores do catálogo. Não invente nomes de grupos nem transfira filtros de outra integração para esta ferramenta.
answer_with_sources
Recebe question, com a pergunta, max_citations, com padrão 3, e a lista opcional source_groups. No canal tributário, retorna uma resposta fundamentada nas evidências disponíveis e informa suas limitações. Para Relações Trabalhistas, use as ferramentas documentais de descoberta e leitura, sem pressupor síntese jurídica.
Exemplo de chamada
Depois de inicializar o cliente e descobrir as ferramentas com tools/list, solicite uma busca:
{
"jsonrpc": "2.0",
"id": 2,
"method": "tools/call",
"params": {
"name": "search_evidence",
"arguments": {
"query": "documentos fiscais IBS CBS 2026",
"research_channel": "tributario_fiscal",
"limit": 5
}
}
}O resultado da ferramenta contém um bloco de texto com JSON. Preserve as evidências, referências e limitações desse conteúdo ao utilizá-lo na conversa.
Investigar e conferir as fontes
Use search_evidence no canal habilitado e confira os links oficiais antes de atribuir uma conclusão à fonte. Para Relações Trabalhistas, descubra as ferramentas de instrumentos coletivos, SST e Obrigações do Empregador com tools/list; respeite identidade, tema, versão e paginação exigidos pelo schema. Um trecho recuperado não substitui a leitura integral do documento.
Quando a questão reunir vários assuntos, faça buscas específicas. Se faltar evidência ou ocorrer uma falha, o assistente deve informar essa limitação em vez de completar a resposta com referências presumidas.
Evidências para a resposta do seu assistente
O assistente pode usar os trechos de search_evidence para construir sua própria resposta ou solicitar uma resposta à FonteIA com answer_with_sources. A disponibilidade dessa resposta varia por canal. Mantenha as citações vinculadas às fontes e distinga o texto oficial da análise gerada pelo assistente. Nunca use outro canal como fallback silencioso.
Fontes, limites e erros
A cobertura depende do acervo disponível. A listagem de grupos não comprova cobertura completa de todos os documentos de uma instituição ou período.
O uso das ferramentas está sujeito às permissões e limites da conta. Consulte as condições vigentes em Planos.
Falhas de ferramenta são identificadas por isError. Confira a mensagem e os detalhes retornados. Falhas de autorização e limites de uso também podem produzir erros HTTP. Um erro do serviço não significa ausência de fontes.
Instalação e referência
Consulte os guias de conexão MCP no Claude e no ChatGPT. Para integrações próprias e Actions, consulte a documentação da API.
Dúvidas técnicas: developer@fonteia.ai.