MCP ou API REST para o seu agente: qual dar, e quando

Dê MCP ao seu agente quando ele precisa descobrir o que pode fazer, e uma API REST quando você já sabe. O MCP traz descoberta e um único fluxo de autenticação, e custa contexto em toda sessão. Um script que publica do mesmo jeito toda noite paga esse custo à toa. Aqui está a linha divisória, com números.

MCP vs API: a tabela

Os dois falam com o mesmo servidor. A diferença é quem lê a documentação: o modelo ou você.

Servidor MCP vs API REST: o que muda de verdade em tempo de execução

MCP é um protocolo JSON-RPC 2.0 em duas camadas: uma camada de dados, que define as primitivas, e uma camada de transporte, que é stdio para um processo local ou Streamable HTTP para um remoto. Um servidor expõe três coisas: ferramentas (funções que o modelo pode chamar), recursos (dados que ele pode ler) e prompts (templates). O cliente chama tools/list para descobrir o que existe e depois tools/call para executar uma delas. Verificado no site da especificação em 9 de outubro de 2026.

Essa etapa tools/list é o ponto central. Uma API REST tem as mesmas operações, mas a lista fica na sua cabeça e no seu código. Com MCP, a lista chega à janela de contexto do modelo, inteira, antes que ele decida se precisa de alguma coisa dela.

Desde a versão do protocolo 2026-07-28, o protocolo é stateless: cada requisição leva a versão e as capacidades em _meta, e server/discover substitui o antigo handshake. Consequência prática para você: um servidor MCP remoto pode ficar atrás de um load balancer sem sticky sessions, e a lista de ferramentas volta com uma dica de cache ttlMs, então um cliente bem-comportado não a busca de novo a cada turno.

O que um agente faz com 103 ferramentas

Vamos ao caso concreto. O servidor MCP do PlugKit expõe 103 ferramentas e 3 workflows, verificados na página de ferramentas em 9 de outubro de 2026. Elas estão agrupadas: 18 para campanhas, 13 para posts, 12 para anúncios da Meta, 10 para contas e conexões, 9 para mensagens, 7 para analytics, 7 para engajamento, até chegar a 2 para busca.

Um agente a quem se pede "responda aos comentários do meu último Reel" precisa de talvez quatro dessas 103. As outras 99 entraram no contexto mesmo assim, com nomes, descrições e input schemas. Esse é o pedágio.

Três coisas reduzem a conta, e as três já existem hoje:

1. Escopos. Uma sessão que tem só mcp:read nunca recebe as ferramentas de escrita registradas, então a lista encolhe antes de chegar ao modelo. Os escopos são mcp:read e mcp:write, documentados na visão geral do MCP.
2. Workflows. O PlugKit oferece três (publish, inbox, report) que os clientes exibem como slash commands. Um comando substitui uma cadeia de chamadas de ferramentas que o modelo teria que planejar, o que significa menos turnos e menos palpites errados.
3. Descoberta progressiva. A especificação tem um padrão para isso: um cliente que federa vários servidores carrega as ferramentas sob demanda em vez de todas de uma vez. Se você tem isso ou não depende do seu cliente, não do servidor.

Um servidor com quatro vezes mais ferramentas tem quatro vezes mais problema. Contei 496 ferramentas no MCP de um concorrente no comparativo de servidores MCP de redes sociais, o suficiente para tirar espaço da conversa que ele deveria servir.

Quando usar MCP

Dê MCP ao agente quando pelo menos uma destas condições for verdadeira:

• A próxima ação depende do que ele lê. Fazer a triagem de uma inbox, decidir qual comentário merece resposta, perceber que um post falhou e escolher outra conta. Você não consegue enumerar essas ramificações de antemão, e é exatamente para isso que serve um modelo.
• Há um humano no loop. Alguém digita "publique isso no Instagram e no LinkedIn às 9h". O MCP transforma essa frase em chamadas sem você precisar lançar uma interface.
• Você não quer guardar credenciais. OAuth 2.1 com PKCE significa que o cliente nunca armazena um segredo de longa duração. O usuário aprova numa tela de consentimento e revoga do mesmo jeito.
• O conjunto de capacidades muda. Um servidor que adiciona ferramentas passa a ser usado sem você lançar nada.

Conectar é uma linha no Claude Code: claude mcp add --transport http --scope user plugkit https://api.plugkit.co/mcp, depois /mcp para autenticar. Cursor, VS Code, os apps do Claude e o ChatGPT em modo de desenvolvedor aceitam a mesma URL, segundo a documentação dos clientes, verificada hoje.

Quando entregar a API REST em vez disso

Dê HTTP a ele quando o trabalho já está decidido antes de o agente rodar:

• Publicação agendada. O payload é conhecido, os destinos são conhecidos. Um POST resolve em 200ms, sem modelo no loop e sem custo de tokens: POST /v1/posts com accountIds e publishNow, documentado no guia de publicação.
• Você precisa de testes. Um teste unitário verifica um status code. Ele não consegue garantir que um modelo vai escolher create_post em vez de publish_post num dia ruim.
• Volume. Milhares de chamadas por hora passando por um modelo é uma conta a pagar, não uma arquitetura.
• Tratamento de erros rigoroso. O PlugKit retorna 402 quando uma cota do plano ou um limite de gastos bloqueia uma chamada, 429 quando você atinge o rate limit, e 404 em vez de 403 para recursos que não são seus. Seu código pode fazer backoff no 429 e disparar um alerta no 402. Um modelo às vezes lê 402 e tenta de novo.

O detalhe útil: no PlugKit, cada ferramenta MCP corresponde a um endpoint REST com o mesmo vocabulário e os mesmos ids. Então os dois não são caminhos opostos. Você prototipa no agente, lê os ids que ele retornou e depois passa a metade repetitiva para o código sem reaprender nada.

Dê os dois, separando pelo determinismo

O que eu de fato uso, e o que eu recomendaria a qualquer pessoa que esteja construindo em cima de uma API de redes sociais: o código cuida de tudo o que é agendado e repetitivo, o agente cuida de tudo o que é conversacional e ambíguo.

Para a parte do agente, a configuração é a mesma qualquer que seja o seu cliente: veja Claude como gestor de redes sociais para saber o que o modelo faz bem e o que eu não entrego a ele, e como dar a um agente de IA acesso às redes sociais para a mecânica por baixo.

Onde o MCP é realmente pior: você perde determinismo, paga em contexto e não consegue comparar duas execuções com facilidade. Quem diz que o MCP substitui seu cliente de API está vendendo um protocolo, não uma arquitetura.

Quanto custa

O PlugKit custa US$ 49 por mês para 5 contas conectadas, com cancelamento a qualquer momento, ou US$ 97 por mês para 30. O servidor MCP e a API REST são o mesmo produto pelo mesmo preço, então a escolha acima é puramente técnica. Sete dias grátis, sem cartão, com uma conta conectada durante o teste. O único extra cobrado por uso é o X: as chamadas são repassadas pela tarifa do próprio X, US$ 0.005 para ler um post e US$ 0.015 para publicar um, com um limite de gasto mensal padrão de US$ 20 por conta até você definir o seu. Números da página de cobrança, verificados em 9 de outubro de 2026.

Perguntas frequentes

Qual é a diferença entre MCP e uma API?

Uma API é a interface; o MCP é uma forma padronizada de entregar essa interface a um modelo. Um servidor MCP quase sempre fica na frente de uma API REST e expõe as mesmas operações como ferramentas que o modelo descobre em tempo de execução com tools/list, em vez de endpoints para os quais você escreve código. O MCP acrescenta descoberta e um fluxo de autenticação uniforme, e custa contexto.

O MCP é melhor que uma API REST para agentes?

Só quando o agente precisa escolher. Se a sequência de chamadas é conhecida antes da execução, um cliente REST é mais rápido, mais barato, testável e determinístico. Se a próxima chamada depende do que a anterior retornou, o MCP compensa o custo de contexto.

Quando devo usar MCP?

Quando uma pessoa está conversando com o agente, quando a próxima ação depende de dados que o agente acabou de ler, quando você prefere não armazenar uma chave de API de longa duração, ou quando a lista de ferramentas muda sem você lançar uma nova versão. Chamadas agendadas, em grande volume e idênticas são o caso oposto.

O MCP consome muitos tokens?

Toda definição de ferramenta da lista entra no contexto: nome, descrição e JSON Schema. Num servidor com 103 ferramentas, isso é um overhead real em toda sessão. Reduza com um escopo somente leitura, que esconde totalmente as ferramentas de escrita, com workflows do lado do servidor que juntam várias chamadas num só comando, e com um cliente que faça descoberta progressiva.

Posso usar o MCP e a API REST ao mesmo tempo?

Sim, e é o que você deve fazer. No PlugKit, cada ferramenta MCP corresponde a um endpoint REST com os mesmos ids, então um agente pode explorar e seu cron job pode publicar nas mesmas contas. Escopos e chaves são separados, então o agente pode ter só leitura enquanto seu código mantém acesso de escrita.

AB

Antoine BlancoFundador da PlugKit. Gerencia as próprias contas de Instagram, YouTube e X pela API e pelo servidor MCP descritos aqui.