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.

La IA de siempre

Claude Code

Codex

Cursor

MCP

Bidireccional, lectura y escritura

Árbol de objetivos de Addness

🎯 100 clientes nuevos en el Q1

Terminar los materiales de propuesta

Ideal, nota, comentarios y entregables

Uses la IA que uses, el destino al que se conecta es el mismo árbol de objetivos. Tanto el avance como el contexto se acumulan aquí

Para quienes empiezan: En el primer paso, “Conectar”, de la pantalla de configuración que se abre al terminar el registro, conectas a Addness la IA que vas a usar (→ Inicio). 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

Lo que puede hacer	Ejemplo
Leer y escribir objetivos	Consultar el árbol de objetivos, crear/actualizar/completar objetivos
ToDo	Responder “¿qué hago hoy?” mirando tus to-dos y objetivos reales
Progreso y actividad	Captar el movimiento del equipo, la actividad de los miembros y los objetivos estancados
Comentarios y notificaciones	Publicar comentarios en objetivos, revisar y gestionar notificaciones
Registro de recursos	Vincular lo que creaste a un objetivo como recurso
Búsqueda de objetivos	Buscar los objetivos de la organización
Conocimiento	Buscar, leer, crear y actualizar el conocimiento de la organización
Drive	Buscar recursos, crear carpetas, mover, enviar a la papelera y restaurar
Grabación de pantalla	Listar grabaciones, leer transcripciones, vincular a objetivos, compartir
Envío de archivos	Enviar archivos grandes, revisar el historial de envíos, desactivar enlaces
Lista de clientes (CRM)	Importar clientes, actualizar etapas, organizar contactos y registrar actividad
Analítica	Crear definiciones de KPI y paneles, actualizar los datos cada mañana
Recorrido del cliente	Crear recorridos, registrar pasos y acciones, registrar las ejecuciones diarias
Bases de datos	Crear tablas y cambiar columnas, leer y escribir filas
Formularios	Crear y publicar formularios, leer respuestas, exportar a CSV
Chat	Leer y escribir en los chats de objetivos, los grupos y los DM, y crear grupos
Reuniones y actas	Solicitar el bot de actas para una reunión, y listar y leer las actas
Mapa mental	Crear mapas, y añadir, editar y mover ramas (nodos)
Plantillas y rutinas	Crear objetivos a partir de plantillas, y programar y cambiar rutinas
Miembros y organigrama	Asignar miembros, establecer superiores y generar enlaces de invitación
Widgets	Colocar los widgets preparados en Inicio y en la página de detalle del objetivo
Network	Buscar personas y organizaciones, ver perfiles, publicaciones y ofertas de empleo, responder a publicaciones
Retos	Informar de que se han terminado los pasos de un reto

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

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

claude mcp login addness

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

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

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

En lugar de pedirlo con palabras, también puedes pasárselo con Addness it a la derecha de la fila de un objetivo (en anchos de móvil también, está justo a la izquierda del ”…” de la fila).

• 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”, “Abrir en Codex”, “Abrir en ChatGPT” o “Abrir en Grok Bot”, 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 Inicio.

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 90 días después de conectar. Pídele a la IA “Vuelve a iniciar sesión en Addness” y pulsa “Permitir” en el navegador
• Al conectar de nuevo aparece un error de límite: Cada persona puede tener hasta 50 conexiones (Además de las conexiones de la IA, las conexiones como las de la app de escritorio también cuentan dentro de las mismas 50). Al llegar a 50, se rechazan las conexiones nuevas (las conexiones actuales siguen funcionando). Sin embargo, al iniciar sesión en la app de escritorio, se corta automáticamente la conexión que lleva más tiempo sin usarse entre las que la app de escritorio y similares crearon automáticamente, y se crea la nueva (las conexiones hechas desde una app de IA no se cortan). Las conexiones antiguas caducan 90 días después de haberse creado, y entonces puedes crear otras nuevas
• En la pantalla “Permitir” aparece “Las conexiones de IA están desactivadas en esta organización. Consultemos con un administrador.”: Un administrador de la organización ha desactivado las conexiones de IA. Pide a un administrador que active “Los miembros pueden conectar su propia IA” en Configuración de la organización › Acceso externo (→ Configuración de la organización). Cuando esté activado, pídele a la IA “Vuelve a iniciar sesión en Addness”
• 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

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.

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

Addness it 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, usa Addness it en tu ordenador con 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 Addness it en la fila “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: Escríbenos desde “Consultas sobre Addness (formulario de soporte)” en la página de inicio de la ayuda. Copia el mensaje de error tal como aparece y, si tienes una captura de la pantalla donde se detuvo, pega en el formulario un enlace para verla

¿Te resultó útil este artículo?

SíNo

← Página anteriorInstalar una app de IA y conectarla con AddnessSiguiente página →Ver cómo usarlo en video

Primeros pasos

• Instalar una app de IA y conectarla con Addness
• Ver cómo usarlo en video