Usar o ChatGPT, o Claude e o Gemini nos seus planos de projeto com MCP

Perguntar a um assistente de IA «o projeto está atrasado?» colando uma lista de tarefas dá respostas plausíveis mas pouco fiáveis: o modelo não conhece as dependências, os calendários nem as folgas, e as datas que propõe não foram calculadas por ninguém.

Com o Model Context Protocol (MCP), a situação muda. O assistente não adivinha: consulta o plano através de ferramentas que usam o motor de planeamento do Planitude, e cada alteração que propõe é recalculada com as mesmas regras do Gantt. Este guia explica o que é o MCP, o que o assistente pode fazer com os seus projetos e como ligar o ChatGPT, o Claude e o Gemini.

O que é o MCP#

O Model Context Protocol é uma norma aberta que permite a aplicações de IA como o Claude ou o ChatGPT ligar-se a fontes de dados, ferramentas e fluxos de trabalho externos; a documentação compara-o a uma porta USB-C para aplicações de IA^[1]. Quem oferece um serviço publica um servidor MCP com uma lista de ferramentas; o assistente descobre-as e usa-as quando ajudam a responder.

Nos planos de projeto, isto significa que o assistente não trabalha sobre uma cópia colada no chat, mas sobre o plano real, com as permissões de quem o ligou.

O que o assistente pode fazer com o seu plano#

O servidor MCP do Planitude disponibiliza ferramentas de leitura e de análise:

• Estado dos projetos: a lista de projetos e uma visão de conjunto que classifica cada um como atrasado, em risco, dentro do prazo ou concluído, com o motivo e os prazos dos próximos sete dias.
• Detalhe do plano: tarefas, datas, dependências e pessoas, com a opção de mostrar apenas as tarefas críticas.
• Caminho crítico: a cadeia de tarefas sem folga, as quase críticas e a distribuição das folgas.
• Impacto de um atraso: «se as demolições atrasarem três dias, quanto derrapa o fim?», comparado com a folga disponível.
• Simulação de Monte Carlo: datas de fim P50, P80 e P95, probabilidade de cumprir o plano ou um prazo, fatores de risco.
• Carga de trabalho: pessoas sobrealocadas e tarefas que causam a sobrealocação.
• Linhas de base, versões e modelos do plano.

Assim, perguntas como «que projetos estão em risco esta semana e porquê?» ou «que probabilidade temos de entregar até 15 de dezembro?» recebem respostas baseadas em cálculos, e não em estimativas do modelo.

Alterações com pré-visualização#

Com permissão de edição, o assistente pode também criar projetos (vazios, a partir de um modelo ou de um plano estruturado com fases, tarefas e ligações) e alterá-los: acrescentar tarefas, atualizar durações e progresso, ligar dependências, guardar uma linha de base, importar um ficheiro .mpp.

As alterações mais amplas passam por uma pré-visualização: o assistente prepara um conjunto de alterações, o Planitude devolve o resultado calculado (nova data de fim, prazos cumpridos ou falhados, conflitos, pessoas sobrecarregadas, caminho crítico) sem guardar nada, e só as aplica depois da confirmação. Se, entretanto, alguém tiver alterado o projeto, as alterações são recusadas e o assistente tem de voltar a ler o plano. O ChatGPT pede ainda, por predefinição, uma confirmação antes de cada ação de escrita^[3].

Segurança: OAuth, permissões e revogação#

As aplicações web como o ChatGPT, o Claude.ai e o Gemini ligam-se com OAuth, o mecanismo de autorização previsto pela especificação MCP, baseado em OAuth 2.1 com PKCE^[2]. Não há palavra-passe para partilhar nem chave para copiar: o assistente abre o Planitude, inicia sessão e vê um ecrã de consentimento que enumera o que poderá fazer.

• A leitura está sempre incluída; as alterações só são concedidas ativando Permitir também alterações.
• Pode limitar o acesso a um único espaço de trabalho.
• O assistente age com as suas permissões: só vê os projetos que o utilizador vê.
• Não pode eliminar projetos ou tarefas nem gerir a sua conta e as suas chaves.
• Pode desligar cada aplicação a qualquer momento em Perfil › Chaves API › Apps conectados.

Para as ferramentas que o preferirem, pode criar uma chave de API com permissões só de leitura ou de leitura e escrita e uma validade opcional; a chave só é mostrada uma vez e a revogação tem efeito imediato.

Ligar o ChatGPT#

A ligação a servidores MCP personalizados passa pelo modo de programador, disponível na Web para os planos Plus, Pro, Business, Enterprise e Education^[3]:

1. no ChatGPT, abra Settings › Security and login e ative o modo de programador^[3];
2. nas aplicações, crie uma nova, cole o URL https://planitude.app/mcp e escolha OAuth como autenticação;
3. inicie sessão no Planitude e permita o acesso;
4. num chat, escolha o modo de programador no menu + e ative o Planitude.

Nas organizações, um administrador pode restringir o modo de programador. Submetemos também a aplicação Planitude ao diretório do ChatGPT, onde está a ser revista pela OpenAI.

Ligar o Claude#

No Claude adiciona-se um conector personalizado, disponível nos planos Free, Pro, Max, Team e Enterprise; no plano Free é possível adicionar um^[4]:

1. abra Customize › Connectors e escolha Add custom connector;
2. cole o URL do servidor; não são precisos um ID de cliente nem um segredo OAuth;
3. escolha Connect, inicie sessão no Planitude e permita o acesso.

Nos planos Team e Enterprise, o conector é adicionado por um Owner em Organization settings › Connectors, e depois cada membro liga-se com a sua própria conta^[4]. O conector funciona no claude.ai, no Claude Desktop e na aplicação móvel.

Ligar o Gemini#

Na aplicação Gemini, a Google reserva para já as aplicações personalizadas baseadas em MCP a contas pessoais de maiores de idade nos Estados Unidos, com a atividade das aplicações Gemini ativada; as contas de trabalho ou escolares não são suportadas^[5]. Se cumprir estes requisitos:

1. em gemini.google.com, abra Settings › Connected Apps e escolha Add a custom app^[5];
2. cole o URL do servidor e siga as instruções;
3. inicie sessão no Planitude e permita o acesso.

A ligação cria-se na Web, mas funciona também na aplicação móvel^[5]. Para todas as outras contas continua disponível o Gemini CLI, descrito na secção seguinte.

Ferramentas para programadores: Claude Code, Codex, Cursor e VS Code#

Os assistentes para programadores aceitam OAuth ou uma chave de API:

• Claude Code: claude mcp add --transport http planitude https://planitude.app/mcp; na primeira utilização, o Planitude abre-se para o consentimento^[6].
• Codex: um bloco [mcp_servers.planitude] em ~/.codex/config.toml, válido para a CLI, a aplicação e a extensão do IDE.
• Gemini CLI: gemini mcp add --transport http planitude https://planitude.app/mcp.
• VS Code com GitHub Copilot: o servidor adiciona-se em .vscode/mcp.json e as ferramentas aparecem no modo Agent^[7].
• Cursor: o servidor adiciona-se em ~/.cursor/mcp.json ou no ficheiro do projeto^[8].

Os exemplos já preenchidos, com o endereço e o marcador da chave, estão no Planitude em Perfil › Chaves API. As restantes integrações, do Jira ao Teams, estão na página Integrações e no guia de integrações; para a API e os webhooks existe a página Programadores.

Perguntas frequentes#