Você já sabe o que é MCP.

Subir o servidor é fácil.Manter útil é que trava.

Cada tool, cada prompt, cada query hoje pede código e deploy. Aqui você salva — e o agente já usa na próxima chamada.

01
Cada ajuste pede um deploy
Mudou a query, o parâmetro, o texto da tool. Sem PR, sem restart. Salvou, chamou, valeu.
02
O contexto do agente envelhece
A base já nasce com busca semântica. Sem infra de search — só o documento, sempre na versão de agora.
03
Tem servidor pra ficar de olho
Nada de processo caindo nem API no ar. É interface: criar, testar, publicar.

Onde o MCP trava de verdade

Não é o protocolo. É o ciclo depois que o servidor já existe.

Melhorar a tool nunca acaba

Adicionar um parâmetro, corrigir uma query, testar se o agente chama a tool certa no prompt certo — cada ajuste passa por código e deploy. Na prática, você para na primeira versão.

2
Escrever o servidor
Auth, transporte, npx, deploy. O tutorial chama de tarde. Nos fóruns, vira o trimestre — e o servidor continua só na sua máquina.
3
O time não entra
stdio local não segue ninguém. Credencial no Slack não escala. No segundo usuário, o setup quebra.
4
O agente decide sozinho
Pega a tool errada, ignora o processo, manda SQL solto no banco. Sem log, você descobre no cliente.

A tool não deveria ser um PR

Postgres ou REST, o mesmo contrato. Salva e já está no MCP.

Prévia

PostgreSQL

get_last_order_by_company

Parâmetro company_id

1select id, status, total, created_at

2from orders

3where company_id = {{company_id}}

4order by created_at desc

Prévia

REST API

get_last_abandoned_cart_by_company

Parâmetro company_id

GET

/v1/companies/{{company_id}}/carts/abandoned/last

O processo fica na cabeça de alguém

Digite @ e o passo a passo aponta a tool. O agente segue o processo em vez de escolher sozinho.

Prévia

Runbook

Carrinho abandonado — cliente sem pedido

# Carrinho abandonado

1. Consulte get_last_order_by_company

2. Se não houver pedido recente:

@get_

get_last_abandoned_cart_by_companyÚltimo carrinho abandonado da empresa.
get_last_order_by_companyPedido mais recente da empresa.
get_companyDados cadastrais da empresa.

O agente pergunta e some

Quando search_documents volta vazio, a pergunta real entra em Lacunas. Você publica o que faltava. Na próxima busca, ele já encontra.

1
A busca falha
O agente pergunta com contexto. Zero documentos.
2
Vira lacuna
A query aparece na fila, agrupada por quantas vezes repetiu.
3
Você treina
Cria o documento a partir da query. O MCP passa a responder.

Prévia

Lacunas

Query	Vezes	Última	Treino
cliente sem pedido recente no checkout	7	há 12 min	Criar documento
reembolso após chargeback recusado	3	há 2 h	Criar documento
automação de e-mail não disparou	2	ontem	Criar documento

Como funciona

1
Crie a org
Conta, time e o tenant. Cada pessoa ganha a URL dela.
2
Ajuste no painel
Docs, um banco ou uma API, as tools. Salva e já vale.
3
Cole no cliente
O snippet de mcp.json sai pronto em Configurar.

Salvou. O agente já usa.

A URL sai pronta. Quem opera escreve a base. Você vê o que ele chamou — e itera de novo.

Criar conta Já tenho conta

Subir o servidor é fácil.Manter útil é que trava.

Onde o MCP trava de verdade

A tool não deveria ser um PR

O processo fica na cabeça de alguém

O agente pergunta e some

A busca falha

Vira lacuna

Você treina

Como funciona

Crie a org

Ajuste no painel

Cole no cliente

Salvou. O agente já usa.