Integração MCP

Conecte ao Addness IAs como Claude Code, Codex, ChatGPT, Cursor e Claude Desktop (integração MCP), e a IA passa a poder ler e escrever objetivos, ToDos, comentários e outros itens do Addness.

Para quem está começando: a página do objetivo de quem acabou de criar uma organização e de quem entrou nela por convite traz "Configurar o Addness". Na linha "1. Conecte sua IA ao Addness" dentro dele, pressione "Pedir à IA" → "Abrir no Claude Code" (ou "Abrir no Codex") e a IA avança em ordem, começando pela conexão com o Addness (→ página do Objetivo). Os passos a partir da instalação do app de IA estão em Instalar um app de IA e conectá-lo ao Addness. Este artigo explica apenas a parte da integração MCP.

Enviar o pedido à IA

Basta enviar este pedido à IA que você usa.

Configure o Addness MCP (https://vt.api.addness.com/mcp).

A IA avança onde consegue e orienta você apenas onde a sua ação é necessária. Apenas a aprovação do login no navegador, faça você mesmo quando a IA orientar.

O que a IA passa a conseguir fazer

Seja qual for a IA conectada, ela lê e escreve na mesma árvore de objetivos da mesma organização.

Se parar no meio do caminho: passos por ferramenta

Se a configuração parar em permissões ou autenticação, mostre à IA os passos abaixo ou continue você mesmo.

ChatGPT (plugin oficial)

Digite “@Addness” no ChatGPT ou selecione o Addness na lista de apps. Selecione “Conectar”, entre no Addness e selecione “Permitir”. Disponível no plano Free. Ações de gravação exigem confirmação. Só é possível conectar uma conta do Addness que já exista (não dá para criar conta pela tela do ChatGPT).

Claude Code (terminal)

1. Adicione o Addness MCP (com --scope user, para ficar utilizável a partir de qualquer projeto)

claude mcp add --transport http --scope user addness https://vt.api.addness.com/mcp

1. Faça login no Addness (quando o navegador abrir, aprove com sua conta Addness)

claude mcp login addness

1. Verifique a conexão (concluído se addness aparecer na lista; você também pode verificar pelo /mcp dentro do Claude Code)

claude mcp list

Codex (CLI)

Dá para usar apenas fazendo login no Addness pelo navegador. Não é preciso criar uma chave de API (o Codex antigo não suporta OAuth, então atualize para a versão mais recente antes de executar).

1. Adicione o Addness MCP (o navegador abre automaticamente, então aprove com sua conta Addness. As configurações são salvas em ~/.codex/config.toml)

codex mcp add addness --url https://vt.api.addness.com/mcp

1. Verifique a conexão (concluído se Auth estiver como OAuth. Se o login não iniciar, execute codex mcp login addness)

codex mcp list

Cursor

1. Abra o ~/.cursor/mcp.json e adicione a configuração a seguir (se você tiver outros servidores, adicione apenas a entrada addness)

{
  "mcpServers": {
    "addness": {
      "url": "https://vt.api.addness.com/mcp"
    }
  }
}

1. Em Settings → Tools & MCP do Cursor, pressione Connect para o addness e aprove com sua conta Addness no navegador

Claude Desktop

Adicione um MCP remoto não por um arquivo de configuração, mas como um conector personalizado.

1. Abra Customize → Connectors e escolha + → Add custom connector
2. Defina o nome como Addness e a URL como https://vt.api.addness.com/mcp e salve (no Team / Enterprise, é necessária a configuração da organização pelo Owner)
3. Pressione Connect para o Addness e aprove no navegador (você pode ativá-lo por conversa em Connectors)

Outros clientes compatíveis com MCP

Qualquer cliente MCP que suporte Streamable HTTP e OAuth pode se conectar.

1. Defina o nome do servidor como addness e o transporte como Streamable HTTP
2. Especifique https://vt.api.addness.com/mcp como destino da conexão
3. Faça login no Addness pelo botão de autenticação do cliente; concluído quando a lista de ferramentas for obtida

Verificar se está conectado

Peça à IA: "Mostre a lista das minhas organizações no Addness". Se ela responder com os nomes das organizações de que você participa, está conectado. Você também pode pedir "Mostre os meus ToDos no Addness" e conferir se ela responde com os seus ToDos.

Se você participa de mais de uma organização, antes de começar a trabalhar, peça à IA: "Mude a organização do Addness para <nome da organização>". A IA troca a organização em que trabalha (switch_organization). Se ela já estiver conectada a essa organização, nada muda. A organização escolhida continua valendo nas próximas conversas com a mesma IA.

Se a resposta for que não há ferramentas do Addness ou que é preciso autenticação, veja Se não conseguir conectar.

Para passar a partir da tela: "Pedir à IA"

Em vez de pedir por palavras, você também pode passar a partir do ✦ ("Pedir à IA") à direita da linha de um objetivo (em larguras de celular, "…" da linha → "Pedir à IA").

• Avançar: a IA lê o contexto daquele objetivo e segue direto
• Explorar ideias: a IA organiza as coisas conversando com você e propõe objetivos filhos. Só são criados os que você aprovar
• Perguntar: escreva o que quer saber e envie; a IA lê o objetivo e responde. O objetivo não é alterado

Ao pressionar "Abrir no Claude Code," "Abrir no Codex" ou "Abrir no ChatGPT," a IA abre com uma instrução que inclui a URL do objetivo e como prosseguir. Com "Copiar instrução," você pode colar em outra IA como o Cursor e usar. Definindo o "Destino da instrução" na seção "AI" das configurações pessoais, você abre com um clique, sem escolher toda vez. Para uma explicação detalhada do que acontece, veja a página do Objetivo.

Diferença da API de integrações externas

A integração MCP faz sua IA ler e escrever no Addness com a sua própria conta conectada. Se seus sistemas só precisam ler os membros e as tarefas de hoje da sua organização, use a API de integrações externas (somente leitura), chamada com uma chave fixa da organização. Chaves de integração externa não funcionam com MCP. Essa API só está disponível para organizações habilitadas pelo Addness.

Se não conseguir conectar

Estes são os problemas mais comuns e como resolvê-los. Como instalar o app de IA e conectá-lo está em Instalar um app de IA e conectá-lo ao Addness.

Não dá para usar as ferramentas do Addness

• Você conectou, mas a IA diz que não há ferramentas do Addness: Em um computador, no Claude Code ou no Codex, Logo depois de conectar, as ferramentas só aparecem quando você abre o app de IA de novo. Encerre o app, abra de novo, escolha a mesma conversa e envie "continue". Fechar a janela não encerra o app. No Mac, encerre com Command + Q. No Windows, feche com Alt + F4 e, se o ícone continuar no canto inferior direito da tela, clique nele com o botão direito e escolha "Sair". No terminal, pressione Ctrl + C duas vezes para encerrar e volte à mesma conversa com claude --resume (no Codex, codex resume)
• Mesmo depois de abrir de novo, ela diz que não há: O Claude Code às vezes só carrega as ferramentas do Addness na hora de usá-las. Diga à IA: "Procure as ferramentas do Addness e use-as"
• A cada ferramenta usada, ela pede permissão e fica parada: Peça à IA: "Configure para você usar as ferramentas do Addness sem me perguntar toda vez". No Claude Code, isso coloca mcp__addness na lista de permissões do arquivo de configuração (~/.claude/settings.json)
• Você tinha removido as ferramentas do Addness para liberar contexto: Enquanto elas estiverem removidas, a IA não consegue ler seus objetivos nem suas tarefas no Addness. Quando trabalhar com o Addness, deixe-as conectadas. Se você as removeu, peça à IA "Ative de novo as ferramentas do Addness" e abra o app de novo
• O Addness não aparece no Claude nem no ChatGPT no navegador: Conecte o Addness pelo plugin oficial no ChatGPT ou por um conector personalizado no Claude pelo navegador. Veja Usar o Addness só no celular.

O login não avança ou a conexão cai

• A tela de login não abre: Peça à IA: "Inicie o login no Addness e mostre a URL". Cole a URL exibida no navegador, abra e pressione "Permitir". Se a tela com "Permitir" não aparecer ou se outro navegador abrir, veja "Se algo não funcionar", em Instalar um app de IA e conectá-lo ao Addness
• Você pressionou "Permitir", mas deu erro: Se a tela de login ficar aberta por um tempo, aparece um erro como "Não foi possível gerar o código de autorização". Peça à IA para iniciar o login de novo e pressione "Permitir" logo na tela que abrir
• Funcionava antes, mas agora pede login, ou pede login várias vezes: A conexão com o Addness expira em 90 dias. Ela cai antes dos 90 dias nestes casos. Se você reconectar a partir do mesmo app de IA, a conexão anterior desse app cai. Cada pessoa pode ter até 20 conexões; passando disso, cai primeiro a conexão que está há mais tempo sem uso (quem usa vários computadores ou várias IAs pode ter conexões antigas cortadas por isso). Peça à IA "Faça login no Addness de novo" e pressione "Permitir" no navegador
• Você confundiu a conta da empresa com a pessoal: A IA se conecta à conta que aparece como "Conectado como …" na tela "Conectar ao Addness MCP". Antes de pressionar "Permitir", confira o endereço de e-mail. Se você conectou com a conta errada, faça login de novo no Addness no navegador com a conta certa e depois peça à IA "Faça login no Addness de novo"

Está conectado a outra organização

• A IA diz que não encontrou o item, ou está lendo objetivos de outra organização: A IA se conecta à organização que estava selecionada no Addness do navegador quando você pressionou "Permitir". Se você participa de mais de uma organização, peça à IA "Mude a organização do Addness para <nome da organização>". Quando passar a URL de um objetivo, mude antes para a organização em que esse objetivo está e só depois faça o pedido

Trava no Windows

• A conexão com o Codex trava no meio, ou os pedidos feitos pelo celular param: Só instalar o app Codex às vezes não deixa o comando codex disponível no computador. No Windows, já houve casos em que essa era a causa. Peça à IA: "Verifique se o comando codex funciona e, se não funcionar, instale". Se você pressionar "Abrir no Codex" e o Codex não abrir, pressione "Copiar instrução", cole no Codex e envie
• No Codex para Windows, o login no Addness não termina: Atualize o Codex para a versão mais recente e faça login de novo. Se ainda assim não terminar, você também pode conectar pelo Claude Code

<a id="mobile-only"></a>

Usar o Addness só no celular

• App do ChatGPT: Digite “@Addness” no ChatGPT ou selecione o Addness na lista de apps. Toque em “Conectar”, entre no Addness e toque em “Permitir”.
• App do Claude: No Safari, abra claude.ai → Personalizar → Conectores → ＋Adicionar → Adicionar conector personalizado → nome Addness e URL https://vt.api.addness.com/mcp → Conectar e permitir. Ative o Addness no app do Claude, cole as instruções e envie.
• Continuar em um computador: Siga As solicitações do celular não chegam para enviar trabalho para a IA no seu computador.

<a id="phone-pc-relay"></a>

Não dá para pedir pelo celular

“As solicitações do celular não chegam” explica como enviar trabalho para a IA em um computador. Para usar apenas o celular, veja “Usar o Addness só no celular”.

O "Pedir à IA" do app do Addness no celular envia o pedido ao Claude Code ou ao Codex do computador. É preciso que o app de desktop do Addness (→ Versão web e aplicativo para desktop) esteja instalado no computador, com login feito na mesma conta do Addness e aberto, e que o computador esteja acordado. A organização aberta no celular e a do app de desktop também precisam ser a mesma. Para essa preparação, peça à IA do computador que faça o objetivo "Peça tarefas à sua IA pelo celular", e a IA conduz o processo. Em computadores Windows da empresa, pode ser que o app de desktop não possa ser executado.

• Aparece "A IA do seu computador ainda não está conectada": A preparação do computador ainda não terminou. Abra o Addness no computador, pressione "Pedir à IA" (✦) em "Peça tarefas à sua IA pelo celular" e siga em frente
• "Vai iniciar quando o PC acordar" continua na tela e nada acontece: O computador está em suspensão, ou o app de desktop está fechado. Acorde o computador e abra o app, e o pedido começa. Depois de 24 horas, o pedido é cancelado
• Aparece "Codex não encontrado no PC": O comando codex não está instalado no computador. Peça à IA do computador "Instale o comando codex" e, depois de instalar, abra o app de desktop de novo
• Você usa o Codex que vem dentro do app do ChatGPT no Mac: O app de desktop não encontra o Codex que fica dentro do app do ChatGPT. Peça à IA do computador "Instale o comando codex" e, depois de instalar, abra o app de desktop de novo (o app de desktop procura o Codex apenas em .local/bin, na sua pasta pessoal, e nos lugares onde o terminal procura comandos)
• Aparece "Escolha uma pasta de trabalho no Addness do PC" ou "Nenhuma pasta de trabalho foi escolhida no Addness do PC": Abra "リモート操作" (Controle remoto) nas configurações do app de desktop no computador e escolha, no topo, em "作業フォルダ" (Pasta de trabalho), a pasta em que a IA vai trabalhar. Até escolher, os pedidos não chegam nem ao Claude Code nem ao Codex
• Aparece "Atualize o Addness do PC": O app de desktop do computador está numa versão antiga. Atualize para a versão mais recente e envie de novo
• Aparece "“Aceitar do celular” do Codex está desativado no Addness do PC": Abra "リモート操作" (Controle remoto) nas configurações do app de desktop no computador e ative "スマホから受け付ける" (Aceitar do celular) na seção "Codex" (escolha antes uma "作業フォルダ" (Pasta de trabalho))
• Não chega ao Claude Code: Confira se o app Claude do celular está conectado com a mesma conta do Claude usada no computador

Se ainda assim não conectar

• Nada do que você tenta conecta: Em alguns casos, o antivírus ou a rede da empresa bloqueiam a comunicação com o Addness. Já houve casos em que a conexão funcionou depois de tirar vt.api.addness.com da verificação nas configurações do antivírus. Em um computador da empresa, fale com o responsável pela TI
• Mesmo tentando tudo isso, nada avança: Anexe uma captura da tela em que parou e fale com a gente em "Dúvidas sobre o Addness", na página inicial da ajuda