# Conectar via MCP

O servidor MCP expõe a operação de cobrança como ferramentas em português. Qualquer assistente compatível cadastra dívidas, consulta status e vê acordos por conversa.

> **Resposta direta:** O servidor MCP da NegociarHoje fica em https://mcp.negociarhoje.com.br (transporte Streamable HTTP), com autenticação OAuth 2.1 com PKCE ou chave de API com escopos. Ele expõe tools como cadastrar_divida, importar_dividas_em_lote, consultar_divida, listar_devedores, suspender_cobranca, informar_pagamento, listar_acordos, resumo_da_carteira, desempenho_da_regua e listar_escalacoes, além de resources com políticas de negociação, templates aprovados, feriados e janelas.

## Conectar no Claude

1. **Abra as configurações de conectores.** Adicione um conector remoto com a URL do servidor MCP.
2. **Autorize.** O fluxo OAuth 2.1 abre o login da NegociarHoje. Escolha a conta e os escopos.
3. **Converse.** "Cadastre a dívida da Ana Souza, CPF 529..., R$ 289,20, vencida em 10/08" ou "Como está a carteira esta semana?".

## Conectar com chave de API

Para agentes de ERP e automações sem usuário interativo, use `Authorization: Bearer nh_live_...` no transporte HTTP. Os escopos da chave limitam as tools disponíveis.

## Tools

| Tool | O que faz |
| --- | --- |
| cadastrar_divida | Cria devedor e título |
| importar_dividas_em_lote | Cria até 1.000 títulos |
| consultar_divida | Status, valor atualizado e histórico |
| listar_devedores | Busca por nome ou documento |
| suspender_cobranca | Pausa a régua de um título |
| informar_pagamento | Baixa informada pelo credor |
| listar_acordos | Acordos e parcelas |
| resumo_da_carteira | Indicadores da carteira |
| desempenho_da_regua | Resultado por etapa e canal |
| listar_escalacoes | Casos na mesa humana |

## Segurança

Mesma camada de serviço da API REST, mesmo isolamento por cliente e mesma auditoria. Tools de escrita exigem escopo de escrita; nada de alterar política de desconto por conversa.

---
Fonte: https://negociarhoje.com.br/docs/mcp (atualizado em 2026-09-29)