Integración MCP

Si conectas a Addness una IA como Claude Code, Codex, ChatGPT, Cursor o Claude Desktop (integración MCP), la IA podrá leer y escribir tus objetivos, ToDo, comentarios y más en Addness.

Para quienes empiezan: Quienes crean una organización nueva y quienes se unen a una organización por invitación tienen "Configurar Addness" en su página del objetivo. En la fila "1. Conecta tu IA a Addness" que contiene, pulsa "Pedir a la IA" → "Abrir en Claude Code" (o "Abrir en Codex") y la IA avanza en orden, empezando por la conexión con Addness (→ página del objetivo). Los pasos desde la instalación de la app de IA están en Instalar una app de IA y conectarla con Addness. Este artículo explica solo la parte de la integración con MCP.

Envía la petición a la IA

Solo envía esta petición a la IA que usas.

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

La IA avanza donde puede y solo te guía donde se necesita tu intervención. Únicamente la aprobación del inicio de sesión en el navegador, hazla tú mismo cuando la IA te guíe hasta ella.

Lo que la IA pasa a poder hacer

Te conectes desde la IA que te conectes, lee y escribe el mismo árbol de objetivos de la misma organización.

Si se detiene a medio camino: pasos por herramienta

Si la configuración se detiene por permisos o autenticación, muéstrale a la IA los pasos de abajo o continúa tú mismo.

ChatGPT (plugin oficial)

Escribe «@Addness» en ChatGPT o selecciona Addness en la lista de apps. Pulsa «Conectar», inicia sesión en Addness y pulsa «Permitir». Disponible en el plan Free. Las acciones de escritura requieren confirmación. Solo puedes conectar una cuenta de Addness que ya tengas (no puedes registrarte desde ChatGPT).

Claude Code (terminal)

1. Añade Addness MCP (con --scope user, para que sea utilizable desde cualquier proyecto)

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

1. Inicia sesión en Addness (cuando se abra el navegador, aprueba con tu cuenta de Addness)

claude mcp login addness

1. Comprueba la conexión (listo si addness aparece en la lista; también puedes comprobarlo desde /mcp dentro de Claude Code)

claude mcp list

Codex (CLI)

Puedes usarlo con solo iniciar sesión en Addness en el navegador. No hace falta crear una clave de API (el Codex antiguo no admite OAuth, así que actualiza a la última versión antes de ejecutarlo).

1. Añade Addness MCP (el navegador se abre automáticamente, así que aprueba con tu cuenta de Addness. Los ajustes se guardan en ~/.codex/config.toml)

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

1. Comprueba la conexión (listo si Auth es OAuth. Si el inicio de sesión no comenzó, ejecuta codex mcp login addness)

codex mcp list

Cursor

1. Abre ~/.cursor/mcp.json y añade el siguiente ajuste (si tienes otros servidores, añade solo la entrada addness)

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

1. En Settings → Tools & MCP de Cursor, pulsa Connect para addness y aprueba con tu cuenta de Addness en el navegador

Claude Desktop

Añade un MCP remoto no mediante un archivo de configuración, sino como un conector personalizado.

1. Abre Customize → Connectors y elige + → Add custom connector
2. Pon el nombre en Addness y la URL en https://vt.api.addness.com/mcp y guarda (en Team / Enterprise se requiere la configuración de la organización por parte del Owner)
3. Pulsa Connect para Addness y aprueba en el navegador (puedes habilitarlo por conversación desde Connectors)

Otros clientes compatibles con MCP

Cualquier cliente MCP que admita Streamable HTTP y OAuth puede conectarse.

1. Pon el nombre del servidor en addness y el transporte en Streamable HTTP
2. Especifica https://vt.api.addness.com/mcp como destino de conexión
3. Inicia sesión en Addness desde el botón de autenticación del cliente; listo una vez que se obtiene la lista de herramientas

Comprobar la conexión

Pídele a tu IA: "Muéstrame la lista de mis organizaciones de Addness". Si responde con los nombres de las organizaciones a las que perteneces, está conectada. También puedes pedirle "Muéstrame mis ToDo en Addness" y comprobar que devuelve tus ToDo.

Si perteneces a varias organizaciones, antes de empezar a trabajar pídele a la IA: "Cambia a la organización 〈nombre de la organización〉 en Addness". La IA cambia la organización en la que trabaja (switch_organization). Si ya está conectada a esa organización, no cambia nada. La organización a la que cambies se mantiene en las siguientes conversaciones con la misma IA.

Si responde que no hay herramientas de Addness o que hace falta autenticarse, consulta Si no se conecta.

Para pasárselo desde la pantalla: "Pedir a la IA"

En lugar de pedirlo con palabras, también puedes pasárselo desde el ✦ ("Pedir a la IA") a la derecha de la fila de un objetivo (en anchos de móvil, desde el "…" de la fila → "Pedir a la IA").

• Avanzar: La IA lee el contexto de ese objetivo y sigue adelante directamente
• Intercambiar ideas: La IA lo ordena hablando contigo y propone objetivos hijos. Solo se crean los que apruebas
• Preguntar: Escribe lo que quieres saber y envíalo; la IA lee el objetivo y responde. No cambia el objetivo

Al pulsar "Abrir en Claude Code", "Abrir en Codex" o "Abrir en ChatGPT", la IA se abre con una instrucción que incluye la URL del objetivo y cómo proceder. Con "Copiar instrucciones," puedes pegarlas en otra IA como Cursor y usarlas. Si eliges el "Destino de las instrucciones" en la sección "AI" de Mi configuración, se abre con un solo clic sin tener que elegir cada vez. Para una explicación detallada de lo que ocurre, consulta la página del objetivo.

Diferencia con la API de integraciones externas

La integración MCP permite que tu IA lea y escriba en Addness con tu propia cuenta. Si solo necesitas que tus sistemas lean los miembros y las tareas de hoy de tu organización, usa la API de integraciones externas (solo lectura), que se llama con una clave fija de la organización. Las claves de integración externa no funcionan con MCP. Esta API solo está disponible para las organizaciones que Addness ha habilitado.

Si no se conecta

Estos son los problemas más comunes y cómo resolverlos. Cómo instalar la app de IA y conectarla está en Instalar una app de IA y conectarla con Addness.

No se pueden usar las herramientas de Addness

• La conectaste, pero la IA dice que no hay herramientas de Addness: En un ordenador, en Claude Code o Codex, Justo después de conectarla, las herramientas no aparecen hasta que vuelves a abrir la app de IA. Cierra la app por completo, vuelve a abrirla, elige la misma conversación y envía "continúa". Cerrar la ventana no cierra la app por completo. En Mac, ciérrala con Command + Q. En Windows, ciérrala con Alt + F4 y, si su icono sigue en la esquina inferior derecha de la pantalla, haz clic derecho en él y elige "Salir". En la terminal, pulsa Ctrl + C dos veces para salir y vuelve a la misma conversación con claude --resume (en Codex, codex resume)
• Sigue diciendo que no hay después de volver a abrirla: A veces Claude Code no carga las herramientas de Addness hasta el momento de usarlas. Dile a la IA: "Busca las herramientas de Addness y úsalas"
• Pide permiso cada vez que usa una herramienta y se detiene: Pídele a la IA: "Configúralo para que puedas usar las herramientas de Addness sin preguntarme cada vez". En Claude Code, mcp__addness se añade a la lista de permisos del archivo de configuración (~/.claude/settings.json)
• Habías quitado las herramientas de Addness para liberar contexto: Mientras estén quitadas, la IA no puede leer ni tus objetivos ni tus to-dos de Addness. Cuando trabajes con Addness, mantenlas conectadas. Si las quitaste, pídele a la IA "Vuelve a activar las herramientas de Addness" y vuelve a abrir la app
• Addness no aparece en Claude ni en ChatGPT en el navegador: Conecta Addness con el plugin oficial en ChatGPT o con un conector personalizado en Claude desde el navegador. Consulta Usar Addness solo en el móvil.

El inicio de sesión no avanza o la conexión se corta

• No se abre la pantalla de inicio de sesión: Pídele a la IA: "Empieza el inicio de sesión en Addness y muéstrame la URL". Pega en el navegador la URL que aparece, ábrela y pulsa "Permitir". Si no aparece la pantalla con "Permitir" o se abre otro navegador, consulta "Si algo no funciona" en Instalar una app de IA y conectarla con Addness
• Pulsaste "Permitir", pero aparece un error: Si la pantalla de inicio de sesión se queda abierta un rato, aparece un error como "No se pudo generar el código de autorización." Pídele a la IA que vuelva a empezar el inicio de sesión y pulsa "Permitir" enseguida en la pantalla que se abre
• Antes funcionaba, pero ahora pide iniciar sesión o la pide una y otra vez: La conexión con Addness caduca a los 90 días. Se corta antes de los 90 días en estos casos. Si vuelves a conectar desde la misma app de IA, se corta la conexión anterior de esa app. Cada persona puede tener hasta 20 conexiones; si se superan, se corta primero la que lleva más tiempo sin usarse (si usas varios ordenadores o varias IA, aquí pueden cortarse conexiones antiguas). Pídele a la IA "Vuelve a iniciar sesión en Addness" y pulsa "Permitir" en el navegador
• Confundiste la cuenta del trabajo con la personal: La IA se conecta a la cuenta que aparece como "Sesión iniciada como …" en la pantalla "Conectar con el MCP de Addness". Comprueba la dirección de correo antes de pulsar "Permitir". Si conectaste la cuenta equivocada, vuelve a iniciar sesión en Addness en el navegador con la cuenta correcta y después pídele a la IA "Vuelve a iniciar sesión en Addness"

Está conectada a otra organización

• La IA dice "no se encontró", o está leyendo objetivos de otra organización: La IA se conecta a la organización que tenías seleccionada en Addness en el navegador cuando pulsaste "Permitir". Si perteneces a varias organizaciones, pídele a la IA: "Cambia a la organización 〈nombre de la organización〉 en Addness". Cuando le pases la URL de un objetivo, haz también que cambie primero a la organización donde está ese objetivo

Se detiene en Windows

• Se detiene al conectar con Codex, o se detienen las peticiones desde el móvil: A veces, con solo instalar la app de Codex, el comando codex no se puede usar en el ordenador. En Windows, hubo casos en que esa era la causa. Pídele a la IA: "Comprueba si funciona el comando codex y, si no, instálalo". Si al pulsar "Abrir en Codex" no se abre Codex, pulsa "Copiar instrucción", pégala en Codex y envíala
• En Codex para Windows, el inicio de sesión en Addness no termina: Actualiza Codex a la última versión y vuelve a iniciar sesión. Si aun así no termina, también puedes conectarte con Claude Code

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

Usar Addness solo en el móvil

• App de ChatGPT: Escribe «@Addness» en ChatGPT o selecciona Addness en la lista de apps. Pulsa «Conectar», inicia sesión en Addness y pulsa «Permitir».
• App de Claude: En Safari, abre claude.ai → Personalizar → Conectores → ＋Añadir → Añadir conector personalizado → nombre Addness y URL https://vt.api.addness.com/mcp → Conectar y permitir. Activa Addness en la app de Claude, pega las instrucciones y envíalas.
• Continuar en un ordenador: Sigue Las solicitudes desde el móvil no llegan para enviar trabajo a la IA de tu ordenador.

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

No puedes pedir tareas desde el móvil

«Las solicitudes desde el móvil no llegan» explica cómo enviar trabajo a la IA de un ordenador. Si solo usas el móvil, consulta «Usar Addness solo en el móvil».

"Pedir a la IA" en la app móvil de Addness envía tu petición a Claude Code o Codex en tu ordenador. Hace falta que la app de escritorio de Addness (→ Versión web y aplicación de escritorio) esté instalada en el ordenador y abierta con la sesión iniciada con la misma cuenta de Addness, y que el ordenador no esté en suspensión. Usa también la misma organización en el móvil y en la app de escritorio. Para prepararlo, pídele a la IA de tu ordenador el objetivo "Encarga tareas a tu IA desde el móvil", y la IA se encarga. En un ordenador Windows de empresa, es posible que la app de escritorio no se pueda ejecutar.

• Aparece "La IA de tu ordenador aún no está conectada": La preparación del ordenador no ha terminado. Abre Addness en el ordenador, pulsa "Pedir a la IA" (✦) en "Encarga tareas a tu IA desde el móvil" y sigue los pasos
• Se queda en "Se iniciará cuando el PC despierte" y no avanza: El ordenador está en suspensión o la app de escritorio está cerrada. Despierta el ordenador y abre la app, y la petición empezará. Pasadas 24 horas, la petición se cancela
• Aparece "No se encontró Codex en el PC": El comando codex no está instalado en tu ordenador. Pídele a la IA de tu ordenador "Instala el comando codex" y, después, vuelve a abrir la app de escritorio
• Usas el Codex que viene dentro de la app de ChatGPT en Mac: La app de escritorio no encuentra el Codex que está dentro de la app de ChatGPT. Pídele a la IA de tu ordenador "Instala el comando codex" y, después, vuelve a abrir la app de escritorio (la app de escritorio busca Codex solo en .local/bin de tu carpeta de inicio y en los lugares donde la terminal busca comandos)
• Aparece "Elige una carpeta de trabajo en Addness en el PC" o "No hay una carpeta de trabajo elegida en Addness en el PC": Abre "リモート操作" (Control remoto) en la configuración de la app de escritorio de tu ordenador y elige, arriba del todo en "作業フォルダ" (Carpeta de trabajo), la carpeta donde trabajará la IA. Hasta entonces, las peticiones no llegan ni a Claude Code ni a Codex
• Aparece "Actualiza Addness en el PC": La app de escritorio de tu ordenador es una versión antigua. Actualízala a la última versión y vuelve a enviar
• Aparece "«Aceptar desde el móvil» de Codex está desactivado en Addness en el PC": Abre "リモート操作" (Control remoto) en la configuración de la app de escritorio de tu ordenador y activa "スマホから受け付ける" (Aceptar desde el móvil) en la sección "Codex" (elige antes una "作業フォルダ" (Carpeta de trabajo))
• No llega a Claude Code: Comprueba que en la app de Claude del móvil has iniciado sesión con la misma cuenta de Claude que en el ordenador

Sigue sin conectarse

• No se conecta con ningún paso: Es posible que un antivirus o la red de tu empresa estén bloqueando la comunicación con Addness. Hubo casos en que se conectó después de excluir vt.api.addness.com del análisis en la configuración del programa. Si es un ordenador de la empresa, consulta al equipo de sistemas
• Sigues sin avanzar después de probar todo esto: Adjunta una captura de la pantalla donde se detuvo y escríbenos desde "Preguntas sobre Addness" en la página de inicio de la ayuda