MCP de minddy

El MCP de minddy permite a un asistente externo utilizar herramientas con los permisos de su cuenta. Conéctelo mediante la configuración de su instancia y revise o revoque su acceso en los ajustes de la cuenta. Antes de cambiar incidencias, páginas o rutinas, consulte los esquemas actuales de las herramientas.

Conectar un asistente externo al MCP de minddy

Abra la página pública de configuración MCP de la instancia y elija las instrucciones de su cliente. Use el endpoint mostrado, terminado en /api/mcp. En self-hosted use su propia instancia, no Cloud. El cliente debe admitir MCP remoto y el flujo OAuth indicado.

Inicie sesión en el navegador y revise la autorización antes de aceptarla. La conexión actúa como su cuenta de minddy y no obtiene proyectos a los que no tiene acceso. Empiece leyendo una incidencia ya accesible y compruebe el proyecto devuelto.

Selecciona tu cliente para ver su comando o configuración de instalación.

Disponibilidad de MCP y acceso a la red

MCP está incluido en minddy autoalojado y se inicia con la aplicación. Funciona directamente en /api/mcp, en el origen de la instancia configurado con MINDDY_PUBLIC_APP_URL. Incluye el descubrimiento OAuth y el registro dinámico de clientes: no necesita un servidor MCP separado, una aplicación OAuth dedicada ni un proxy de minddy Cloud. Conecte su cliente MCP al endpoint de su instancia, inicie sesión y conceda acceso mediante el consentimiento en el navegador.

La disponibilidad del servicio no garantiza que sea accesible por la red. Tanto el cliente MCP como el navegador de autorización deben poder acceder a las URL MCP y OAuth anunciadas. Si define explícitamente OAUTH_ISSUER, ese origen también debe ser accesible. El cliente debe admitir la conexión, el flujo OAuth y la ruta de red elegida; algunos clientes exigen HTTPS incluso en redes privadas.

• Mismo ordenador: http://localhost:6463/api/mcp funciona con un cliente compatible que se ejecuta en el ordenador que aloja la instancia local. localhost y 127.0.0.1 identifican el ordenador que inicia la conexión. El lanzador de instancias locales de la aplicación de escritorio solo escucha en la interfaz de bucle local; otro ordenador o un agente alojado en la nube no puede acceder directamente. Abrir la URL localhost del servidor en otro ordenador apunta a ese otro ordenador.

• LAN o VPN: una instancia configurada como http://192.168.1.50 anuncia http://192.168.1.50/api/mcp. Un cliente de la LAN, o conectado por VPN, puede utilizarla si la dirección de escucha, el origen configurado, el puerto de la aplicación, el cortafuegos y el enrutamiento permiten el acceso. El navegador debe acceder a las mismas URL de autorización anunciadas. Esto requiere una instalación de servidor accesible; cambiar solo la URL del cliente no expone un proceso limitado al bucle local.

• Fuera de la red privada: utilice un origen HTTPS accesible, como https://tickets.example.com/api/mcp, u otra ruta de red admitida por el cliente. Un agente alojado necesita su propia ruta a la instancia; la VPN del ordenador del navegador no le proporciona esa ruta. Alojar minddy localmente no lo expone automáticamente a Internet.

Alcance y revocación

Los clientes externos usan herramientas disponibles para incidencias, planes, comentarios, páginas, feedback, ciclos, rutinas y cuaderno dentro de sus permisos. Las herramientas siguen su rol actual en cada proyecto en cada llamada, de modo que un cambio de rol se aplica sin volver a conectarse. Como lector, obtiene las herramientas de lectura, y también las de comentarios cuando el propietario le ha activado Puede comentar. MCP está disponible en todos los planes Cloud; la IA del cliente sigue dependiendo de su configuración y costes.

minddy MCP en los ajustes de cuenta muestra accesos externos y controles de revocación. Revoque clientes que ya no use o considere fiables. La tarjeta MCP para Numo de la pestaña IA y Numo es distinta: conecta Numo a otros servicios. No pegue tokens de acceso en incidencias, solicitudes públicas de feedback, sus comentarios ni capturas.

Este ejemplo conecta con minddy Cloud. Para el autoalojamiento, utilice el origen de su propia instancia; el comando mostrado no se ejecutó para esta captura.

Usar minddy MCP y descubrir herramientas actuales

minddy expone /api/mcp mediante Streamable HTTP, herramientas sin estado y OAuth 2.1. Conecte su propia cuenta mediante el consentimiento en el navegador; las antiguas claves estáticas mdyk_ no se aceptan. Empiece con minddy_list_projects para obtener los UUID de proyectos accesibles y lea los esquemas del servidor conectado. /llms-full.txt se genera a partir de esos registros y proporciona los parámetros actuales exactos. No deduzca herramientas de una lista antigua. Las herramientas de proyecto vuelven a comprobar el acceso y devuelven códigos de error estables.

Leer antes de cambiar planes

Para encontrar una incidencia, llame a minddy_list_issues con query: busca palabras del título y la descripción, un identificador o un número. Las coincidencias de texto y los identificadores exactos van primero; una búsqueda descriptiva puede añadir después incidencias del mismo proyecto encontradas por el sentido, marcadas con match: "semantic". Lea esa incidencia antes de actuar sobre ella. La búsqueda por el sentido se cobra a su cuenta como Búsqueda de incidencias y no se realiza si desactivó Indexar incidencias.

minddy_get_issue acepta un UUID de incidencia, un identificador como DEMO-42 o un número de incidencia con project_id. Sus plan_tasks proporcionan task_index desde cero. minddy_update_plan_task recibe un lote tasks con estados pending, in_progress, completed o cancelled; un índice inválido rechaza todo el lote. Añada contenido con minddy_append_to_plan y cambie un pasaje con minddy_edit_issue_text usando old_string/new_string exactos y únicos. Relea si el texto ha cambiado: reemplazar todo el plan puede sobrescribir el progreso de otra persona. Las preguntas bajo ## Questions no cuentan como tareas del plan.

Las lecturas que devuelven texto con imágenes (minddy_get_issue, minddy_get_objective, minddy_get_page, minddy_get_feedback, minddy_get_scratchpad) las listan en images, cada una con su src y su texto alternativo. Pase ese src sin cambios a minddy_get_image: comprueba su acceso al proyecto de la imagen, o que una imagen del cuaderno sea suya, y devuelve la imagen hasta 10 MB con una download_url firmada válida unos diez minutos. Una imagen alojada fuera de minddy se devuelve solo como su URL.

Respetar revisiones y propiedad

minddy_list_pages muestra la jerarquía, minddy_search_pages encuentra extractos y minddy_get_page lee el Markdown completo, los comentarios y los valores de base de datos. Prefiera cambios parciales y utilice la versión actual para un reemplazo completo. Conserve exactamente las URL de archivos e imágenes. minddy_create_page con database=true crea una base de datos de páginas. minddy_update_page_database exige la revisión del esquema y el valor anterior para los cambios de celdas.

Para convertir una propiedad, indique operation=convert, propertyId, targetType, revision y primero preview=true. Revise incompatibleCount y envíe después los mismos ajustes de conversión con preview=false y el token devuelto. Use confirmLoss=true solo si el usuario ha autorizado expresamente la pérdida de valores incompatibles.

Las herramientas de rutinas, reservadas al propietario, crean, modifican, pausan o eliminan rutinas cuyo desencadenante es una programación, un evento o una nueva entrada de base de datos. Lea las rutinas existentes antes de crear una nueva para evitar duplicados. minddy_add_resource limita los archivos a 10 MB; las herramientas de páginas no inventan URL.

Comprobar con un ejemplo

El ejemplo cambia la primera tarea de un plan ya leído. Sustituya el UUID del proyecto y la incidencia por los valores obtenidos mediante descubrimiento; task_index debe proceder de la última lectura. Compruebe los plan_tasks y plan_progress devueltos. Ante un error de acceso, revise la cuenta y la autorización del proyecto; ante un conflicto de versión, vuelva a leer y aplique solo el cambio previsto. No repita una modificación externa de resultado incierto antes de comprobarlo.

{
  "project_id": "00000000-0000-4000-8000-000000000001",
  "issue": "DEMO-42",
  "tasks": [{"task_index": 0, "state": "in_progress"}]
}

Elegir un objetivo para un comentario

Las lecturas de comentarios incluyen objective_id; minddy_list_feedback acepta un filtro de objetivo opcional (null selecciona solicitudes sin objetivo). Usa minddy_link_feedback_objective con project_id, feedback_post_id y objective_id solo cuando el usuario lo pida explícitamente; null elimina el vínculo. El objetivo debe estar activo y pertenecer al mismo proyecto. El detalle del objetivo incluye linked_feedback. El propietario puede indicar objective_id en minddy_create_integration para una clave de comentarios, o cambiar el ajuste con minddy_update_integration_objective. Los comentarios existentes conservan su elección. La conversión hereda objetivo y categorías; la revisión de Numo nunca asigna objetivos.