Aviso: Esta documentação foi gerada por inteligência artificial e pode conter erros.
A integração MCP expõe recursos da API de Parceiros como ferramentas para clientes compatíveis com Model Context Protocol, usando transporte Streamable HTTP. O endereço é https://<DOMINIO_DO_PROVEDOR>/api-parceiros/mcp.
McpApiParceiros). Sem confirmação da assinatura, a configuração fica bloqueada e o servidor recusa acesso.As credenciais MCP são geradas pelo servidor e independem do token da API REST. Use o domínio da instalação e envie a autorização OAuth.
*. O callback inicial do Claude já vem cadastrado; confira os demais callbacks na configuração do cliente.O link documentação do MCP abre /api-parceiros/mcp/docs na instalação, com os detalhes de conexão. Alterações em redirect URIs, ferramentas e ativação precisam ser salvas. Geração e rotação de credenciais são ações próprias no servidor.
A aba Tools agrupa consultas e escritas por domínio. A seleção é aplicada tanto na listagem oferecida ao cliente quanto na execução. Inicialmente, sem restrição configurada, todas ficam habilitadas; uma seleção vazia não permite ferramentas.
Há consultas de clientes, financeiro, contratos, acessos, planos, formas de pagamento, pré-cadastros, atendimentos e ordens de serviço. Algumas ferramentas também executam ações reais:
| Ferramenta | Efeito |
|---|---|
atendimento_criar |
Cria um atendimento. |
ordem_servico_criar |
Cria ou atualiza uma ordem de serviço. |
pre_cadastro_criar |
Cria pré-cadastro; com confirmar=true, também efetiva a venda. |
pre_cadastro_confirmar |
Cria/reaproveita cliente, cria contrato e contrata o serviço do plano. |
acesso_desbloqueio_em_confianca |
Libera temporariamente um acesso conforme as regras do sistema. |
cliente_desconectar_acesso / acesso_desconectar |
Derruba a conexão ativa do acesso. |
Revise especialmente as ferramentas de escrita. A indicação de leitura/escrita ajuda na escolha, mas a autorização efetiva depende de salvar a seleção. O catálogo técnico completo fica em /api-parceiros/mcp/tools; esse catálogo é público e contém metadados, enquanto tools/list reflete a seleção da empresa autenticada.
| Uso | Fluxo |
|---|---|
| Cliente com autorização no navegador | OAuth com authorization_code, PKCE S256 e redirect URI cadastrada; permite renovação por refresh_token. |
| Aplicação própria de servidor | client_credentials, usando Client ID e Client Secret; dispensa redirect URI e não retorna refresh token. |
O access token dura 15 minutos. No fluxo client_credentials, solicite outro quando expirar; offline_access é recusado nesse fluxo. As chamadas MCP usam Authorization: Bearer <ACCESS_TOKEN>.
As credenciais atuais são compartilhadas pelos consumidores MCP do provedor. Todo token representa a integração; a autorização no navegador não identifica um operador do LHISP.
Use Rotacionar Client Secret quando precisar substituir o segredo. A confirmação avisa que os consumidores atuais serão desconectados. A rotação revoga os refresh tokens e exige atualizar todos os integradores que usam aquela credencial. O novo segredo também é mostrado uma única vez.
Para suspender o acesso, desmarque Integração ativa e salve. Para retirar uma capacidade específica, remova a ferramenta da seleção e salve.
A aba Logs de operações permite consultar as chamadas de ferramentas, com resultado e duração. Os argumentos são mascarados; a gravação é assíncrona, e uma falha no log não desfaz a operação.
| Situação | Verificação |
|---|---|
| Configuração bloqueada ou acesso negado pelo módulo | Confira assinatura ativa e comunicação da instalação com a gerência. |
| Segredo não aparece ao reabrir a tela | Comportamento esperado; se ele não foi guardado, rotacione e reconfigure os clientes. |
| Erro de redirect URI | Cadastre exatamente o callback HTTPS usado pelo cliente, sem curinga, e salve. |
| Ferramenta não aparece/é recusada | Confira a seleção salva, ativação da integração e token atual. |
| Token expirado em aplicação própria | Solicite novo access token com client_credentials. |
| Erro 413 ao enviar anexos | O corpo MCP tem limite padrão de 1 MB, incluindo base64. A API REST possui limite próprio, padrão de 25 MB nas rotas de escrita. |
Um retorno de erro pode ocorrer depois de algum efeito de negócio, como a venda confirmada com faturamento da instalação pendente. Consulte o resultado e o registro criado antes de repetir uma escrita.