API: conectar um assistente de IA ao sistema pelo MCP

O MCP (Model Context Protocol) é um padrão aberto que deixa um assistente de inteligência artificial operar o sistema em linguagem natural: "liste minhas vendas do mês", "cadastre um cliente". Serve tanto para assistentes de conversa quanto para editores de código, desde que aceitem servidor MCP remoto.

Você não instala nada. O sistema já oferece o servidor MCP pronto; você só aponta o assistente para o endereço e informa uma chave de API. A IA usa essa chave e só faz o que a chave pode fazer.

Caminho

Meus aplicativos › Ver todos os aplicativos › API (botão Acessar)

Na tela inicial do aplicativo, clique no cartão MCP, ou no item MCP do menu lateral.

Como conectar

1. Crie uma chave de API na tela Credenciais (o cartão ao lado). Guarde o Access Token e o Secret Access Token: o Secret aparece uma vez só.
2. No seu assistente de IA, adicione um servidor MCP remoto com o endereço que aparece no campo Endereço do servidor. O botão ao lado copia o endereço.
3. Informe o Access Token e o Secret Access Token da chave nos cabeçalhos access-token e secret-access-token.

Se o seu assistente usa arquivo de configuração, a tela já traz o Arquivo de configuração montado. Clique em Copiar, cole no arquivo do seu assistente e troque os dois valores de exemplo pelos códigos da sua chave.

O endereço do servidor é o da sua conta. Use sempre o que a tela mostra.

O que o assistente consegue fazer

Conectado, o assistente enxerga o mesmo que a API de integração: pode listar os recursos disponíveis, ver o que cada um exige, consultar registros e cadastrar, alterar ou excluir. Ele também consulta a central de ajuda do sistema para entender regra de negócio antes de agir.

Antes de qualquer ação que altere dados (cadastrar, editar, excluir), o servidor exige que o assistente confirme com você. Consulta não precisa de confirmação.

As mesmas regras da API valem aqui

A chave de API é a identidade do assistente. Tudo o que vale para a integração vale para o MCP:

  • Ele entra como um usuário e uma loja da sua conta, e obedece às permissões, ao horário e às restrições de acesso desse usuário. Se a chave não pode ver algo, o assistente também não vê.
  • Chave revogada ou vencida deixa o assistente sem acesso, com as mesmas mensagens da API: "Access Token e/ou Secret Access Token incorreto(s)!" ou "Token expirado!".
  • Quem tem o arquivo de configuração com os dois códigos age em nome da sua empresa. Não compartilhe. Se vazar, revogue a chave e crie outra.

Quando dá errado

  • O assistente diz que não autenticou — confira se os dois códigos foram informados nos cabeçalhos certos e se a chave não foi revogada nem venceu.
  • O assistente não encontra o servidor — o endereço tem de ser o que a tela MCP mostra, copiado inteiro.
  • O assistente vê menos do que eu vejo na tela — é a permissão do usuário que a chave representa. Veja a fonte sobre quem o token é quando entra.
  • O assistente pede confirmação toda vez que vai gravar — é o esperado. Alteração de dados sempre passa por confirmação.