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.

A IA de sempre

Claude Code

Codex

Cursor

MCP

Nos dois sentidos, leitura e escrita

Árvore de metas do Addness

🎯 100 novos clientes no Q1

Finalizar o material de proposta

Ideal, memorando, comentários e entregáveis

De qualquer IA que você use, o destino da conexão é a mesma árvore de metas. O progresso e o contexto se acumulam aqui

Para quem está começando: Na primeira etapa, “Conectar”, da tela de configuração que abre depois do cadastro, você conecta ao Addness a IA que vai usar (→ Início). 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

O que consegue fazer	Exemplo
Ler e escrever objetivos	Conferir a árvore de objetivos, criar/atualizar/concluir objetivos
ToDos	Responder “o que eu faço hoje?” olhando suas tarefas e objetivos reais
Progresso e atividade	Entender o movimento da equipe, a atividade dos membros e os objetivos parados
Comentários e notificações	Postar comentários em objetivos, conferir e tratar notificações
Registro de recursos	Vincular o que você fez a um objetivo como recurso
Busca de objetivos	Buscar os objetivos da organização
Conhecimento	Buscar, ler, criar e atualizar o conhecimento da organização
Drive	Buscar recursos, criar pastas, mover, enviar para a lixeira e restaurar
Gravação de tela	Listar gravações, ler transcrições, vincular a objetivos, compartilhar
Envio de arquivos	Enviar arquivos grandes, conferir o histórico de envios, desativar links
Lista de clientes (CRM)	Importar clientes, atualizar estágios, organizar contatos e registrar atividade
Analytics	Criar definições de KPI e dashboards, atualizar os dados toda manhã
Jornada do cliente	Criar jornadas, registrar etapas e ações, registrar as execuções diárias
Bancos de dados	Criar tabelas e alterar colunas, ler e gravar linhas
Formulários	Criar e publicar formulários, ler respostas, exportar em CSV
Chat	Ler e escrever nos chats de objetivos, grupos e DMs; criar grupos
Reuniões e atas	Solicitar o bot de atas para reuniões, listar e ler atas
Mapa mental	Criar mapas; adicionar, editar e mover ramos (nós)
Templates e rotinas	Criar objetivos a partir de templates, agendar e alterar rotinas
Membros e organograma	Atribuir membros, definir gestores, emitir links de convite
Widgets	Colocar os widgets prontos em Início e na página de detalhes do objetivo
Network	Buscar pessoas e organizações, ver perfis, publicações e vagas, responder a publicações
Desafios	Informar que as etapas de um desafio foram concluídas

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

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

claude mcp login addness

3. 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

2. 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"
    }
  }
}

2. 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: Addness it

Em vez de pedir por palavras, você também pode passar com Addness it à direita da linha de um objetivo (em larguras de celular também, ele fica logo à esquerda do ”…” da linha).

• 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,” “Abrir no Codex,” “Abrir no ChatGPT” ou “Abrir no Grok Bot,” 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 Início.

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 90 dias depois de feita. Peça à IA “Faça login no Addness de novo” e pressione “Permitir” no navegador
• Ao tentar fazer uma nova conexão, aparece um erro de limite: Cada pessoa pode ter até 50 conexões (Além das conexões da IA, conexões como a do app de desktop também contam nas mesmas 50). Ao chegar a 50, novas conexões são recusadas (as conexões atuais continuam funcionando). Porém, ao fazer login no app de desktop, entre as conexões criadas automaticamente pelo app de desktop e similares, a que está há mais tempo sem uso é cortada automaticamente e a nova conexão é criada (as conexões feitas por um app de IA não são cortadas). As conexões antigas expiram 90 dias depois de feitas, e aí você pode fazer novas de novo
• A tela “Permitir” mostra “As conexões de IA estão desativadas nesta organização. Vamos consultar um administrador.”: Um administrador da organização desativou as conexões de IA. Peça a um administrador que ative “Membros podem conectar sua própria IA” em Configurações da organização › Acesso externo (→ Configurações da organização). Depois de ativado, peça à IA “Faça login no Addness de novo”
• 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

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.

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 Addness it 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, use Addness it no computador com 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 Addness it na linha “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: Fale com a gente em “Dúvidas sobre o Addness (formulário de suporte)”, na página inicial da ajuda. Copie a mensagem de erro exatamente como aparece e, se tiver uma captura da tela em que parou, cole no formulário um link de compartilhamento dela

Este artigo foi útil?

SimNão

← AnteriorInstalar um app de IA e conectá-lo ao AddnessPróximo →Veja como usar em vídeo

Começar

• Instalar um app de IA e conectá-lo ao Addness
• Veja como usar em vídeo