MCP

Ligar o Codex ao MCP do Taskavel

Configure o Codex para o MCP do Taskavel com OAuth por predefinição ou um token Bearer privado quando for necessária uma credencial estática.

O Codex pode utilizar o servidor MCP remoto do Taskavel para consultar e trabalhar com a conta Taskavel disponível na ligação. Utilize OAuth quando o Codex o disponibilizar para o servidor. Quando precisar deliberadamente de uma credencial estática, configure um token de acesso pessoal através de uma variável de ambiente, em vez de colocar o valor diretamente na configuração.

O endpoint MCP de produção é:

https://taskavel.com/mcp/taskavel

Adicione o servidor

Adicione a entrada seguinte à configuração do utilizador em ~/.codex/config.toml ou à configuração .codex/config.toml de um projeto fidedigno quando esta for adequada à ligação:

[mcp_servers.taskavel]
url = "https://taskavel.com/mcp/taskavel"

Numa configuração compatível com OAuth, o Codex utiliza OAuth por predefinição quando o servidor o disponibiliza. Siga a aprovação no navegador, confirme que iniciou sessão na conta Taskavel pretendida e verifique a ligação com um pedido de leitura, como «Lista os meus projetos do Taskavel».

Utilize um PAT apenas quando for necessária autorização estática

Crie um PAT identificado em Configurações da conta → Integração de IA (MCP). Guarde o valor numa variável de ambiente privada, por exemplo TASKAVEL_MCP_TOKEN, através do sistema operativo ou gestor de segredos. Depois, configure o Codex para referenciar essa variável:

[mcp_servers.taskavel]
url = "https://taskavel.com/mcp/taskavel"
bearer_token_env_var = "TASKAVEL_MCP_TOKEN"

Não substitua o nome da variável pelo token real no ficheiro TOML. O Codex também suporta http_headers e env_http_headers para configurações que precisem de cabeçalhos HTTP, mas bearer_token_env_var é a escolha mais clara para um PAT do Taskavel. Mantenha privada a configuração ao nível do utilizador; utilize uma configuração de projeto apenas quando todos os colaboradores e ambientes de execução fidedignos devam ter a mesma definição de servidor, nunca o mesmo token em bruto.

Verifique e trabalhe em segurança

Peça primeiro ao Codex que liste projetos ou consulte uma tarefa conhecida. Se a autenticação funcionar, mas faltar um projeto, verifique a conta e a associação no Taskavel em vez de criar outro token. Nas escritas, identifique o projeto, o destino e o resultado pretendido. Peça ao Codex que comunique correspondências ambíguas antes de agir.

O Taskavel aplica as funções normais do utilizador ligado. Consulte as operações disponíveis na referência gerada de Ferramentas MCP, em especial a classificação de leitura, escrita e destrutiva. A eliminação permanente exige uma tarefa já arquivada e confirmação explícita. Revogue um PAT ou desligue uma ligação OAuth em Integração de IA (MCP) quando essa configuração do Codex já não deva ter acesso.

Last reviewed 26 de jul. de 2026