O que é MCP (Model Context Protocol) e como usar no seu agente de IA

MCP (Model Context Protocol) é um padrão aberto que define como um agente de IA descobre e usa ferramentas de outros sistemas. Em vez de cada integração ser construída sob medida, o serviço publica um servidor MCP com as ações que oferece, e qualquer agente compatível passa a usá-las: buscar uma issue no Jira, listar pagamentos no Stripe, abrir um ciclo no Linear.

A comparação mais usada é a do USB-C: um conector único que funciona com qualquer aparelho que siga o padrão. O MCP faz isso entre modelos de IA e ferramentas.

Animação: à esquerda, cada agente ligado a cada ferramenta por uma integração própria, num emaranhado de linhas; à direita, todos passam por um único conector MCP — Sem padrão, cada par agente e ferramenta pede uma integração. Com MCP, um conector serve para todos.

Este guia explica o que é o protocolo, como ele funciona por dentro, quando ele faz diferença e como conectar um servidor MCP a um agente do CollaborAI, recurso que chegou na versão 1.5.

De onde veio o MCP

O protocolo foi lançado pela Anthropic em novembro de 2024, como especificação aberta. Em pouco tempo, OpenAI, Google, Microsoft e boa parte das ferramentas de trabalho adotaram o padrão. Depois, a especificação foi doada à Agentic AI Foundation, uma fundação neutra, para que nenhuma empresa sozinha controle o rumo do protocolo.

Na prática, isso significa duas coisas para quem usa IA no trabalho:

Os próprios fornecedores mantêm os servidores. Quem publica o servidor MCP do Jira é a Atlassian; o do Stripe, a Stripe. Quando a ferramenta ganha uma função nova, o servidor costuma ganhar junto.
Uma integração serve para vários agentes. O mesmo servidor funciona com o seu agente no CollaborAI e com outros clientes compatíveis.

Como o MCP funciona

São três peças:

Peça	O que é	No CollaborAI
Servidor MCP	O serviço que expõe as ferramentas (ex.: o servidor do Linear)	Fica no fornecedor, na internet
Cliente MCP	Quem conversa com o servidor, lista as ferramentas e faz as chamadas	A própria plataforma
Agente	O modelo de IA que decide qual ferramenta usar e com quais dados	O seu agente

O fluxo é sempre o mesmo. Ao conectar, o cliente pergunta ao servidor quais ferramentas ele tem. Cada uma vem com nome, descrição e os parâmetros que aceita, por exemplo list_issues com filtro de status. Quando você pede ao agente “quais issues de alta prioridade estão abertas?”, o modelo escolhe a ferramenta certa, preenche os parâmetros e recebe a resposta para montar o texto final.

Animação: o cliente MCP pergunta ao servidor quais ferramentas existem e recebe list_issues; o agente escolhe e chama a ferramenta pelo cliente; o servidor devolve a resposta — O cliente descobre as ferramentas, o agente escolhe qual usar e o servidor devolve o resultado.

O ponto central é que ninguém precisa programar essa ponte. O servidor descreve o que sabe fazer, e o modelo lê essa descrição.

MCP, API e habilidade personalizada: qual a diferença

Se você já conectou um endpoint seu ao agente com as habilidades personalizadas, a pergunta é natural.

API comum: cada endpoint precisa ser configurado, com URL, método, parâmetros e autenticação. Serve para o seu sistema, que não tem servidor MCP.
Servidor MCP: o fornecedor já empacotou dezenas de ações, com descrições escritas para IA. Você conecta uma vez e escolhe quais ações o agente pode usar.

As duas convivem. Para o ERP interno da sua empresa, habilidade personalizada. Para Jira, Linear ou Stripe, servidor MCP.

Como conectar um servidor MCP no CollaborAI

Os servidores MCP ficam em Conectores, no card Servidores MCP. O caminho:

Clique em Adicionar servidor MCP.
No Catálogo, escolha um serviço pronto: Atlassian (Jira e Confluence), Linear ou Stripe. Para outro serviço, escolha Servidor personalizado (URL) e informe o endereço HTTPS do servidor.
Escolha a autenticação. O padrão é OAuth: você entra na conta do serviço numa janela do próprio fornecedor e autoriza o acesso. As alternativas são Chave de API (cabeçalhos) e Sem autenticação, para servidores públicos.
A plataforma testa a conexão e lista as ferramentas que o servidor oferece.
No agente, na seleção de ferramentas, a seção Servidores MCP mostra os servidores conectados. Marque só as ferramentas que esse agente precisa.

Etapa de autenticação de um servidor MCP encontrado, com as opções Autorizar com OAuth, Chave de API em cabeçalhos e Sem autenticação — Servidor encontrado: falta escolher como a CollaborAI vai se autenticar nele.

Nos serviços do catálogo, cada ferramenta já vem classificada como Leitura ou Escrita. Em servidores personalizados, a classificação vem do próprio servidor, e por isso a plataforma é mais conservadora com eles.

Ferramentas de um servidor MCP personalizado sem indicação do servidor, marcadas como Escrita e bloqueadas, com o botão Permitir escrita — Se o servidor não declara que a ferramenta só lê, ela é tratada como escrita e fica bloqueada.

Quem pode usar

Plano	Servidores MCP
Free	Não disponível
Pro	Até 3
Enterprise	Até 3

A CollaborAI não cobra nada por chamada MCP. A execução do agente conta na cota mensal de execuções do seu plano, e o que o serviço externo cobrar pelo uso da API dele segue sendo com ele.

Leitura liberada, escrita sob controle

Conectar um servidor não dá ao agente poder de alterar nada. As regras que valem para todo servidor:

Escrita bloqueada por padrão. Criar uma issue, comentar ou mexer em um pagamento exige dois passos: liberar a escrita na página do servidor, com uma confirmação explícita, e depois marcar ferramenta por ferramenta no agente.
Canal público é só leitura. Agentes com chat público ou WhatsApp não aceitam ferramentas de escrita de nenhum servidor, nem servidores personalizados. Um visitante anônimo não pode comandar uma ação na sua conta.
Mudou, reaprova. A plataforma relê as ferramentas dos servidores. Se um servidor alterar uma ferramenta que um agente usa, ela precisa ser aprovada de novo.
Teto por execução. Cada execução do agente faz no máximo 25 chamadas MCP. Se chegar no limite, o agente responde com o que já tem.
Credencial guardada cifrada. O token de acesso fica cifrado na plataforma e não é entregue ao modelo.

Esse desenho existe porque o MCP traz um risco novo: o agente lê conteúdo de terceiros (uma issue, uma descrição de ferramenta) e esse conteúdo pode tentar dar ordens a ele. O assunto ganha um post próprio em breve aqui no blog.

Exemplos do que dá para fazer

Jira e Confluence: “resuma o que mudou na sprint atual e liste os bloqueios”, ou “ache a página do Confluence que explica o processo de deploy”.
Linear: “quais issues da equipe de Mobile estão sem responsável?”.
Stripe: “quais faturas venceram esta semana e não foram pagas?”.

Com um gatilho de agendamento, essas perguntas viram rotina: o agente consulta toda segunda às 8h e manda o resumo por e-mail.

Perguntas frequentes

MCP é gratuito?

O protocolo é aberto e não tem licença. No CollaborAI, os servidores MCP estão nos planos Pro e Enterprise, sem custo por chamada. O serviço do outro lado pode ter as próprias regras de preço.

Posso usar MCP no Chat, sem criar um agente?

Ainda não. Nesta versão, quem usa as ferramentas dos servidores MCP são os agentes. Para usar essas ferramentas, crie um agente e marque nele as ferramentas do servidor.

Funciona com servidor MCP local, rodando no meu computador?

Não. A plataforma se conecta a servidores remotos, acessíveis por HTTPS na internet. Servidores que rodam só na sua máquina ou em uma rede interna são recusados.

Qual a diferença entre um servidor do catálogo e um personalizado?

Os do catálogo foram revisados pela CollaborAI: o endereço é conferido e cada ferramenta tem a classificação de leitura ou escrita definida. No personalizado, quem declara o que é leitura é o próprio servidor, e a escrita só existe se você liberar.

O agente enxerga tudo o que existe na minha conta?

Com OAuth, ele enxerga o que o seu usuário enxerga no serviço, porque a autorização é feita com a sua conta. Dentro disso, só usa as ferramentas que você marcou no agente.

Se você já tem um agente rodando, o teste mais rápido é conectar o Linear ou o Jira em modo somente leitura e pedir um resumo do que está aberto. Em cinco minutos dá para ver se o MCP resolve o seu caso.