Skip to main content
Se você quer conectar um agente, aplicação ou ferramenta própria ao MCP da Salvy, esta página reúne os requisitos técnicos e o catálogo das ferramentas disponíveis. A documentação principal explica o MCP de forma mais prática. Aqui você encontra os detalhes para quem precisa configurar, desenvolver ou validar uma integração.

​
Antes de começar

Para usar o MCP da Salvy, você precisa de:
  • uma conta ativa na Salvy;
  • acesso às empresas que deseja consultar ou gerenciar;
  • um cliente ou aplicação compatível com MCP via Streamable HTTP;
  • uma forma de autenticação válida;
  • permissões para realizar as operações desejadas.
O MCP da Salvy está disponível em:
O endpoint utiliza Streamable HTTP e aceita requisições POST.

​
Compatibilidade

O MCP da Salvy utiliza o transporte Streamable HTTP, permitindo que clientes compatíveis com MCP se conectem diretamente ao servidor. A implementação atual:
  • utiliza POST para comunicação com o servidor;
  • não utiliza stdio;
  • não utiliza o transporte legado de SSE;
  • não mantém uma sessão entre requisições;
  • não exige Mcp-Session-Id.
A compatibilidade final também depende do cliente de IA ou aplicação utilizado para fazer a conexão.

​
Descoberta de ferramentas

Depois de autenticar, o cliente pode consultar as ferramentas disponíveis no servidor usando tools/list. As ferramentas são organizadas em dois grandes grupos:
  • Leitura: consulta de informações da operação da Salvy;
  • Escrita: ações que alteram dados ou podem gerar efeitos na conta.
O servidor informa as ferramentas disponíveis, seus parâmetros e suas descrições para que o cliente possa decidir qual utilizar.

​
Importante

A disponibilidade de uma ferramenta na descoberta não significa que qualquer usuário possa executá-la. Autenticação, permissões e regras da operação são verificadas quando a ferramenta é chamada.

​
Catálogo de ferramentas

Se você quer saber exatamente o que o MCP da Salvy pode fazer, este é o lugar.

​
Leitura

​
Escrita

​
Operações em lote

Algumas ferramentas permitem trabalhar com várias linhas de uma vez. Os limites variam de acordo com a operação:
  • bloqueio e desbloqueio: até 50 linhas;
  • organização em grupos: até 100 linhas;
  • centro de custo: até 100 linhas;
  • adição de dados: até 25 linhas e 10 GB;
  • alteração de plano: até 25 linhas.
As operações em lote respeitam as regras específicas de cada ferramenta. Quando uma operação é atômica, uma falha impede que parte da alteração seja aplicada.

​
Resultados e estados

As ferramentas podem retornar mais do que um simples success ou error. Algumas operações podem informar estados diferentes de uma execução concluída, como:
  • operação aplicada;
  • operação já aplicada;
  • operação agendada;
  • resultado indisponível para determinado período ou dado.
Para operações assíncronas, o resultado inicial pode indicar que a solicitação foi aceita ou agendada. Nesse caso, uma nova consulta pode ser necessária para verificar o estado final.

​
Para desenvolvedores

Se você está construindo uma integração própria, recomendamos começar por:
  1. conectar ao endpoint do MCP;
  2. configurar a autenticação;
  3. executar tools/list;
  4. selecionar uma ferramenta de leitura;
  5. validar os parâmetros e o formato do resultado;
  6. só depois habilitar operações de escrita.
Para uma primeira integração, prefira começar com ferramentas de consulta. Isso permite validar autenticação, descoberta e interpretação dos resultados antes de introduzir operações que alteram dados ou geram cobrança.

​
Referência rápida