O que é MCP e como conectar o Claude ao quadro de tarefas do time

Muita gente já usa o Claude ou o ChatGPT no trabalho, mas de um jeito que ainda dá trabalho: copia o contexto de um lugar, cola na conversa com a IA, copia a resposta e cola de volta. A IA ajuda, mas fica do lado de fora, sem enxergar o trabalho do time.

O MCP é o que tira a IA dessa janela isolada. Este guia explica o que ele é, o que muda na prática e como conectar um agente ao quadro de tarefas do time.

O que é MCP

MCP significa Model Context Protocol. É um padrão aberto, criado pela Anthropic e hoje adotado por boa parte das ferramentas de IA, que define como um assistente de IA conversa com outros sistemas.

A comparação mais usada é a do USB-C: em vez de cada ferramenta inventar a própria integração com cada IA, a ferramenta oferece um servidor MCP, e qualquer cliente MCP (Claude, Codex, Cursor e outros) consegue se conectar a ele.

Na prática, o servidor MCP diz à IA:

• quais ações existem, como listar cards, ler um card, comentar ou abrir um card novo;
• o que cada ação precisa receber e o que ela devolve;
• quem está pedindo, por meio de uma autorização que você aprova ou de uma chave de acesso.

A IA então decide sozinha quando usar cada ação, dentro do que essa autorização permite.

O que muda quando a IA enxerga o quadro

Sem MCP, você pergunta à IA e ela responde com base no que você colou. Com MCP, você pode pedir coisas como:

• "Lê os cards da coluna Em revisão e me diz quais estão parados há mais de três dias."
• "Abre um card para cada item desta ata de reunião, no espaço do cliente X."
• "Pega a próxima atividade da etapa Redação, segue a instrução da etapa e comenta o resultado no card."

A diferença é que a IA trabalha dentro do sistema do time: o que ela faz fica registrado no card, visível para todo mundo, como se fosse mais uma pessoa do time.

Agente não é pessoa: as regras que importam

Dar acesso de uma IA ao trabalho do time pede alguns cuidados. Antes de conectar qualquer agente, confira se a ferramenta oferece:

1. Uma identidade própria para cada agente. Assim fica claro, em cada comentário ou mudança, o que foi feito por uma pessoa e o que foi feito por um agente.
2. Acessos que você revoga a qualquer momento, por agente ou por aplicativo, sem afetar os outros.
3. Limites sobre o que o agente pode assumir. Nem toda etapa do processo deveria ser executada por IA. O ideal é você marcar quais podem.
4. Instruções escritas por etapa, para que o agente siga o mesmo procedimento que uma pessoa seguiria.
5. Proteção para dados sensíveis, para que dados de clientes não sejam enviados à IA sem necessidade. (Veja o guia sobre dados de clientes, IA e LGPD.)

Passo a passo: conectando o Claude ao Ocary

O endereço do servidor MCP do Ocary é:

https://app.ocary.ai/mcp

Não é preciso copiar chave nenhuma: você cola o endereço, entra no Ocary e aprova o acesso.

No Claude (web, Desktop e celular)

1. No Claude, abra Configurações → Conectores e adicione um conector personalizado com o endereço acima. Nos planos Team e Enterprise, quem adiciona é o dono da organização no Claude.
2. Clique em Conectar. Abre uma página do Ocary: entre com a sua conta, se ainda não estiver conectado.
3. Na tela do Ocary que pergunta Conectar Claude ao Ocary?, escolha em nome de quem o Claude vai agir (veja abaixo) e clique em Permitir acesso.

Pronto: o conector aparece como conectado e o Claude passa a enxergar o quadro. Depois de configurado no Claude web, ele também fica disponível no Desktop e no celular.

No Claude Code

No terminal:

claude mcp add --transport http ocary https://app.ocary.ai/mcp

Depois, dentro do Claude Code, digite /mcp, escolha ocary e Authenticate. O navegador abre a mesma tela de autorização do Ocary.

Em nome de quem o Claude age

Se você tem agentes no Ocary, a tela de autorização pergunta Conectar como:

• Você: o Claude age com o seu nome e as suas permissões. Bom para uso pessoal, como resumir o quadro ou abrir cards para você.
• Um dos seus agentes: o que o Claude fizer aparece com o nome do agente, e valem as regras de agente, como só executar as etapas marcadas como automatizáveis. Bom quando o Claude vai trabalhar na fila do time.

Para criar um agente, vá em Perfil → Agentes antes de conectar.

No Codex e em outros clientes que pedem uma chave

Se o cliente não oferece autorização pelo navegador, use uma chave de API. Em Perfil → Agentes, crie um agente e gere uma chave para ele (ela aparece uma vez só). No Codex, o servidor fica no arquivo ~/.codex/config.toml, com a chave numa variável de ambiente, e não no arquivo:

[mcp_servers.ocary]
url = "https://app.ocary.ai/mcp"
bearer_token_env_var = "OCARY_TOKEN"

E, no terminal, antes de abrir o Codex:

export OCARY_TOKEN="<sua chave>"

Teste com um pedido simples

Peça algo de leitura primeiro, como "Liste os espaços que você consegue ver no Ocary". Se a resposta vier certa, a conexão está funcionando. Depois, teste uma ação de escrita pequena, como comentar num card de teste. Nas ações que alteram ou substituem algo que já existe, o Claude pede a sua confirmação antes.

Como desconectar

No Ocary, abra Perfil → Tokens de API. Em Aplicativos conectados ficam todas as conexões que você aprovou, inclusive as feitas em nome dos seus agentes. Clique em Desconectar: o acesso para na hora. Desativar um agente também desconecta tudo o que estava conectado em nome dele.

Se algo não funcionar

• A tela do Ocary diz que você precisa fazer parte de uma empresa: o acesso é sempre a uma empresa. Crie a sua ou aceite o convite de alguém do time.
• O Claude diz que perdeu o acesso: a conexão pode ter sido desconectada em Tokens de API, ou o seu acesso (ou o do agente) foi desativado na empresa. Conecte de novo.
• Uma ação é recusada com uma mensagem do Ocary: a mensagem diz o motivo, como um card que não existe ou uma etapa que não é automatizável. Peça ao Claude para seguir o que ela indica.
• Ainda não funcionou: escreva para [email protected] contando o que aconteceu.

O que um agente consegue fazer no Ocary

Pelo servidor MCP, o Claude (ou outro agente) pode:

• listar espaços, cards, atividades, comentários e documentos;
• ler um card, uma atividade ou um documento;
• abrir cards novos, atualizar título e descrição e comentar;
• assumir uma atividade de uma etapa marcada como automatizável, seguir a descrição da etapa e concluir, o que leva o card para a próxima etapa;
• devolver um card ao backlog;
• ler e desenhar fluxos de trabalho: etapas, ligações, o que cada etapa espera e quais um agente pode executar;
• criar e editar documentos, sem nunca ver os trechos marcados como privados.

O agente só assume as etapas que você liberou. As outras continuam com as pessoas do time.

Por onde começar

Comece com tarefas de leitura e organização, que têm risco baixo: resumir o que está parado, transformar uma ata em cards, revisar um texto e comentar. Depois que o time confiar no resultado, libere uma etapa inteira do processo. O guia quais etapas um agente de IA pode assumir ajuda a escolher.