Guia · API x MCP
API e MCP.
Duas portas para a mesma conta.
A API conecta sistemas: o seu código decide cada chamada. O MCP conecta assistentes de IA aos mesmos dados: o agente descobre as ferramentas e escolhe qual usar a partir de uma pergunta. Este guia mostra a diferença na prática, com a mesma pergunta respondida pelos dois caminhos.
Resposta curta
Em 30 segundos.
A diferença está em quem monta a chamada.
- APIPara sistemas que você programa
Uma lista de endereços, os endpoints, com regras fixas. O desenvolvedor escreve cada chamada no código, com os campos exatos, e a mesma entrada produz o mesmo efeito. Serve para automatizar: emitir cobranças, pagar lotes, alimentar o ERP.
- MCPPara assistentes de IA que conversam
Um padrão aberto que liga assistentes como o Claude a sistemas externos. O servidor MCP descreve as ferramentas que oferece; o agente lê essas descrições e decide qual chamar para responder a uma pergunta em linguagem natural. Serve para consultar e analisar.
- Na TrioOs mesmos dados nos dois
Cada ferramenta do Trio MCP espelha um endpoint de leitura da API da Trio: o agente vê os mesmos documentos, status e identificadores que a sua integração. O Trio MCP é somente leitura; pagamentos saem pela API ou pelo app, com as alçadas de aprovação da conta.
1.0 API
A API é o pedido exato.
Cada campo no lugar, toda vez.
Pense num pedido de compra: o formulário tem campos fixos, e o fornecedor só aceita se tudo vier preenchido do jeito combinado. Uma API (Application Programming Interface) funciona assim. Ela publica os endereços, chamados endpoints, e o formato de cada pedido. O seu sistema envia a requisição, a API responde, e o resultado é previsível.
- ContratoO formato é público e fixoA API da Trio é descrita em OpenAPI, o padrão que define interfaces HTTP de um jeito que pessoas e máquinas entendem o serviço sem ler o código dele.
- Quem decideO desenvolvedor escreve cada chamadaQual endpoint, em que ordem, com quais filtros e o que fazer com a resposta: tudo fica no código da integração, escrito e testado antes.
- ResultadoPrevisível e repetívelA mesma requisição produz o mesmo efeito. Por isso a API é o caminho para operações em volume, como pagar 2.400 fornecedores ou emitir 10 mil boletos no mês.
- ExemploUm Pix pela API da TrioPOST /v2/out/pix/async com a conta de origem (bank_account_id), o valor em centavos e o recebedor. A resposta traz o documento criado, e um webhook avisa quando o Pix liquida.
2.0 MCP
O MCP é a tomada universal da IA.
Um encaixe, vários assistentes.
O Model Context Protocol é um padrão aberto, lançado pela Anthropic em novembro de 2024 e hoje mantido na Agentic AI Foundation, da Linux Foundation. A documentação do MCP usa a comparação com o USB-C: assim como uma porta padrão liga aparelhos diferentes, o MCP liga assistentes de IA a dados e ferramentas externos sem uma integração sob medida para cada par.
- HostO assistente que você usaO aplicativo de IA, como o Claude. Ele abre um cliente MCP para cada servidor conectado.
- ServidorO sistema que oferece as ferramentasUm programa que expõe ferramentas, dados e modelos de prompt. O Trio MCP é um servidor hospedado pela Trio.
- tools/listO agente pergunta o que existeAo conectar, o cliente pede a lista de ferramentas. Cada uma vem com nome, descrição de quando usar e o formato dos argumentos.
- tools/callO agente escolhe e chamaDiante de uma pergunta, o modelo escolhe a ferramenta que responde, preenche os argumentos e lê o resultado. Quem monta a chamada é o agente, na hora.
3.0 Na prática
A mesma pergunta,
dois caminhos.
"Quanto pagamos à Vértice Engenharia em setembro?" Pela API, alguém escreve o código que busca, percorre as páginas e soma, e a resposta aparece num painel. Pelo MCP, a pessoa pergunta no assistente, e o agente chama as ferramentas do Trio MCP. O número é o mesmo, porque a fonte é a mesma.
- APIMelhor quando a pergunta se repeteVira relatório, painel ou automação: o código roda todo mês, do mesmo jeito.
- MCPMelhor quando a pergunta é novaAnálises pontuais e conferências antes de aprovar, sem esperar um relatório novo.
4.0 Por que o MCP existe
De 20 conexões para 9.
O adaptador de tomada da IA.
Sem um padrão, cada assistente de IA precisa de uma integração própria com cada sistema: 4 assistentes e 5 sistemas somam 20 integrações sob medida. Com um protocolo comum, cada lado se liga ao padrão uma vez: 4 + 5 = 9. Foi esse o problema que a Anthropic apontou ao lançar o MCP: cada nova fonte de dados exigia a sua própria implementação.
- Sem padrão4 × 5 = 20Integrações sob medidaCada par de assistente e sistema tem o seu código, a sua autenticação e a sua manutenção.
- Com MCP4 + 5 = 9Conexões ao padrãoCada sistema publica um servidor MCP uma vez, e qualquer assistente compatível passa a usá-lo.
- E a API?Continua por baixoUm servidor MCP costuma chamar uma API por trás. O MCP não substitui a API: ele a deixa utilizável por agentes.
5.0 Lado a lado
A comparação completa.
Ponto a ponto.
As diferenças que pesam na escolha, com o que vale especificamente na Trio.
| Aspecto | API | MCP |
|---|---|---|
| Quem usa | Sistemas e desenvolvedores | Assistentes de IA e as pessoas que conversam com eles |
| Quem monta a chamada | O código, escrito antes | O agente, na hora, a partir da pergunta |
| Como se descobre o que existe | Lendo a documentação (OpenAPI) | O servidor lista as ferramentas (tools/list) |
| Formato | HTTP com JSON, um endpoint por operação | JSON-RPC 2.0, ferramentas com descrição e esquema de argumentos |
| Acesso na Trio | Credenciais da integração (HTTP Basic) | Login da pessoa no navegador, com acesso limitado à organização |
| Previsibilidade | Alta: mesma entrada, mesmo efeito | O agente pode seguir caminhos diferentes; a resposta deve ser conferida |
| O que faz na Trio | Leitura e escrita: pagamentos, cobranças, contas | Somente leitura: saldos, extratos, pagamentos, recebimentos e cartões |
| Para começar | Desenvolver e testar no Sandbox | Adicionar o Trio MCP ao assistente e entrar com o seu usuário |
| Melhor para | Automação em volume e processos repetidos | Perguntas, análises e conferências pontuais |
6.0 Segurança
Agentes consultam, analisam e explicam.
Pessoas aprovam.
Dar acesso a um agente não é entregar a chave do cofre. O próprio padrão MCP recomenda o mínimo privilégio: o acesso começa só com o necessário. O Trio MCP leva isso ao limite, e nenhuma ferramenta movimenta dinheiro. Quando um pagamento precisa sair, ele sai pela API ou pelo app e passa pelas alçadas de aprovação da conta.
- Trio MCPSomente leituraNenhuma ferramenta cria pagamentos, transferências ou estornos, emite cartões ou altera configurações.
- Trio MCPUma organização por acessoCada chamada roda com as credenciais da sessão e enxerga só os dados daquela organização. Números de cartão e CPFs chegam mascarados.
- APICredenciais da integraçãoQuem escreve pela API usa credenciais próprias, guardadas nos servidores da empresa e nunca no navegador.
- ContaAs alçadas valem semprePagamentos seguem as regras de aprovação por valor e por CNPJ definidas na conta.
7.0 Quando usar
Escolha pelo trabalho,
não pela moda.
Quatro situações comuns no financeiro e o caminho que resolve cada uma. Escolha uma para ver a rota.
Referências
para ir mais fundo.
Perguntas
frequentes.
O MCP substitui a API?
Não. O MCP é uma camada para agentes de IA, e um servidor MCP normalmente chama uma API por trás. Na Trio, cada ferramenta do Trio MCP espelha um endpoint de leitura da API. Integrações que automatizam pagamentos e cobranças continuam na API.
Preciso saber programar para usar o Trio MCP?
Não. Basta adicionar o Trio MCP a um assistente compatível, como o Claude, e entrar com o seu usuário da Trio. Para usar a API é preciso desenvolver a integração, e o Sandbox permite testar sem dinheiro real.
O agente pode fazer pagamentos pelo Trio MCP?
Não. Todas as ferramentas do Trio MCP são somente leitura: nenhuma cria pagamentos, transferências ou estornos. Um agente que execute pagamentos precisa ser construído sobre a API, com credenciais próprias, e os pagamentos passam pelas alçadas de aprovação da conta.
É seguro conectar um assistente de IA à conta da empresa?
O Trio MCP segue o mínimo privilégio: só leitura, acesso limitado a uma organização e números de cartão e CPFs mascarados. Cada pessoa entra com o próprio usuário, e o agente vê apenas o que aquela organização vê. Mais detalhes em Segurança.
Quais assistentes funcionam com o Trio MCP?
O Claude e outros clientes compatíveis com MCP. O passo a passo de conexão está na documentação do Trio MCP.
Os números do agente batem com os da integração?
Sim, porque a fonte é a mesma: as ferramentas usam os mesmos documentos, status e identificadores da API. Ainda assim, confira os números antes de decidir, como faria com qualquer análise.