Servidor MCP local del tablero

El servidor MCP local del tablero (el paquete @irakasi/board-mcp) es un pequeño programa que funciona en tu ordenador y da a tu aplicación de IA las herramientas para ver y editar tableros. Se configura y conecta en la sección Servidor MCP local del tablero del diálogo Usa IA con este tablero, en la cabecera del tablero:

• Configurarlo una vez por aplicación de IA: añade el servidor a cada aplicación de IA que uses (consulta Añadir el servidor a tu aplicación de IA).
• Conectar cada pestaña del navegador: un tablero tiene que estar abierto en una pestaña del navegador conectada para que tu asistente pueda editarlo. Una pestaña conectada sigue conectada cuando abres otro tablero en ella (consulta Conectar un tablero).
• Añadir archivos y generar o editar imágenes: si tu aplicación de IA permite generar imágenes, tu asistente puede crear o editar imágenes directamente en el tablero (consulta Crear y editar imágenes). También puede añadir imágenes, vídeos y otros archivos desde tu ordenador, mientras que el WebMCP del tablero necesita un enlace web o un archivo pequeño enviado en el mensaje.

Qué necesitas

Antes de configurar el servidor local, asegúrate de tener:

• Node.js 20 o posterior: instalado en tu ordenador para que tu aplicación de IA pueda ejecutar el paquete del servidor.
• Una aplicación de IA compatible: una aplicación de IA en tu ordenador que pueda ejecutar servidores MCP locales.
• Una pestaña de tablero abierta: el tablero abierto en tu navegador para poder conectar su pestaña al servidor.

Añadir el servidor a tu aplicación de IA

Esto se hace una vez para cada aplicación de IA. Si tu aplicación de IA puede cambiar su propia configuración, lo más rápido es pedírselo. Copia esta petición en tu aplicación de IA:

Añade el servidor MCP de tableros de Irakasi a tu configuración de MCP. Es el paquete de npm @irakasi/board-mcp (https://www.npmjs.com/package/@irakasi/board-mcp). Ejecútalo con el comando `npx -y @irakasi/board-mcp@latest stdio` y llámalo irakasi-boards. Cuando termines, dime cómo reiniciarte para que cargue el servidor.

Configurarlo tú

También puedes copiar la configuración para tu aplicación de IA desde el diálogo de conexión:

• Operación:
  1. Abre Usa IA con este tablero en la cabecera del tablero.
  2. En la sección Servidor MCP local del tablero, abre Instrucciones de configuración y elige tu aplicación de IA.
  3. Copia su configuración y añádela a tu aplicación de IA como indican las instrucciones.
  4. Cierra y vuelve a abrir tu aplicación de IA.
• Resultado: tu aplicación de IA puede iniciar el servidor cuando tu asistente usa Irakasi.

Dónde guarda cada aplicación de IA su configuración de MCP:

Conectar un tablero

Conecta una pestaña de tablero abierta en tu navegador al servidor local:

• Operación:
  1. Pide a tu asistente que use Irakasi, por ejemplo "Muestra mis tableros de Irakasi". Algunas aplicaciones de IA solo inician el servidor cuando tu asistente lo usa por primera vez, así te aseguras de que esté en marcha.
  2. Abre Usa IA con este tablero en la cabecera del tablero.
  3. En la sección Servidor MCP local del tablero, elige Conectar al servidor local.
• Necesita: el servidor añadido a tu aplicación de IA.
• Resultado: la pestaña se conecta al servidor y tu asistente puede trabajar en el tablero abierto en ella.

La sección Servidor MCP local del tablero muestra uno de estos estados:

• Sin vincular: esta pestaña no está conectada.
• Conectando: la pestaña se está conectando al servidor.
• Esperando al servidor local: Irakasi espera hasta un minuto a que tu aplicación de IA inicie el servidor. Detener conexión cancela la espera.
• Esperando a una aplicación de IA: la pestaña está conectada al servidor, pero ninguna aplicación de IA está conectada a él en este momento.
• Conectado: la pestaña está conectada y al menos una aplicación de IA usa el servidor. La sección también muestra la versión del servidor y cuántas aplicaciones de IA hay conectadas.
• Servidor local desconectado: la pestaña perdió la conexión con el servidor, por ejemplo después de cerrar tu aplicación de IA. Vuelve a conectarse sola cuando el servidor se inicia de nuevo.

Una vez conectada una pestaña:

• Sigue conectada en esta pestaña: la conexión dura mientras la pestaña siga abierta, también después de recargar la página o de abrir otro tablero en la misma pestaña.
• Varias pestañas y aplicaciones de IA: puedes conectar varias pestañas de tableros al mismo servidor, y varias aplicaciones de IA pueden usarlo a la vez.
• Desconectar: elige Desconectar del servidor local para terminar la conexión de la pestaña con el servidor local (el WebMCP del tablero sigue funcionando).

Para detener el acceso de un agente mientras mantienes la pestaña conectada:

• Operación: abre Actividad de los agentes bajo el botón de conexión y activa Bloquear acceso en la tarjeta de ese agente.
• Resultado: el nombre del agente se atenúa y el botón se vuelve rojo. Sus peticiones en espera y las nuevas se rechazan en las pestañas de Irakasi de este navegador, incluso después de recargar; una petición que ya esté ejecutándose termina.
• Permitir el acceso de nuevo: desactiva el bloqueo. Reiniciar la aplicación de IA inicia una conexión nueva sin bloquear (consulta Bloquear un agente).

Tus otros tableros

A través de cualquier pestaña conectada, tu asistente también puede leer tus otros tableros guardados en este navegador sin abrirlos, por su nombre exacto o por su ID del tablero:

• Editar el contenido de otro tablero: para cambiar los elementos o las animaciones de un tablero, tu asistente abre ese tablero en una pestaña conectada.
• Gestionar tableros guardados: tu asistente puede renombrar, duplicar o eliminar tableros guardados sin abrirlos. Eliminar un tablero así no se puede deshacer.

Añadir imágenes y archivos al tablero

Con el servidor local, tu asistente puede generar o editar imágenes con sus propias herramientas de imagen y añadir archivos de tu ordenador directamente al tablero:

• Generación y edición de imágenes con IA: si tu aplicación de IA permite generar imágenes, tu asistente puede crear imágenes nuevas y colocarlas en el tablero, o editar imágenes que ya estén en el tablero (incluidas zonas seleccionadas, capas y máscaras en el Editor de imágenes; consulta Crear y editar imágenes). Para una imagen que Codex genere en tu conversación, tu asistente identifica esa imagen exacta antes de añadirla.
• Carpeta privada de preparación: por defecto, el servidor crea su propia carpeta privada en tu ordenador y solo lee archivos de ahí. Tu asistente sabe dónde está esa carpeta y guarda o copia allí el archivo antes de añadirlo al tablero.
• Tus propias carpetas: para que tu asistente añada archivos directamente desde tus propias carpetas, como Imágenes, añade esas carpetas a la configuración del servidor (consulta la página del paquete @irakasi/board-mcp).
• Permisos en Codex: cuando Codex pida permiso para importar un archivo, elige Allow for this session para autorizar las siguientes importaciones en esa sesión. Editar imágenes o gestionar tableros puede requerir otro permiso.

Actualizaciones y reinicios

La configuración pide la última versión publicada cada vez que el servidor se inicia, así que nunca tienes que reinstalarlo:

• Cargar una versión nueva: tu aplicación de IA suele iniciar el servidor al abrir la aplicación o al empezar una conversación nueva, y un servidor en marcha conserva su versión hasta que se reinicia. Cuando el tablero necesita una versión más nueva, la sección Servidor MCP local del tablero muestra un aviso que te pide reiniciar el servidor desde tu aplicación de IA, o cerrar y volver a abrir la aplicación.
• Reconectar después de una pausa: la conexión de tu aplicación de IA puede cerrarse cuando tu asistente lleva 2 horas sin usar Irakasi, aunque haya un tablero conectado. Si tu asistente ya no puede usar Irakasi, reinicia la conexión MCP en tu aplicación de IA, o cierra y vuelve a abrir la aplicación.

Privacidad

El servidor MCP local del tablero limita el acceso a tu ordenador y a las pestañas que conectas:

• Conexiones solo locales: el servidor funciona solo en tu ordenador y solo acepta conexiones de programas que se ejecutan con tu cuenta de usuario en el mismo equipo.
• Solo pestañas conectadas: el servidor solo llega a las pestañas de tableros que conectas, y lee los tableros únicamente a través de esas pestañas abiertas.
• Informes anónimos de problemas: con los informes activados, tu asistente puede enviar a Irakasi informes anónimos de problemas.

Si no se conecta