Documentación

English

MCP para agentes

Conecta cualquier cliente MCP a tus reuniones de Mico, alojadas en la nube de Mico.

El servidor MCP de Mico está alojado en la nube: lee tus reuniones sincronizadas desde los servidores de Mico, así que un agente puede usarlo desde cualquier máquina, incluso desde las que no tienen instalada la app de escritorio. Requiere un plan que incluya el servidor MCP (Flow), y la comprobación se hace en el servidor en cada petición.

Conectar un cliente

  1. En la app de escritorio, abre Ajustes → Desarrolladores → MCP y crea un token de acceso personal. El token se muestra una sola vez; solo se guarda su hash.
  2. Copia el comando de conexión que aparece a su lado. Para Claude Code tiene este aspecto:
claude mcp add --transport http mico \
  https://<project>.supabase.co/functions/v1/mcp \
  --header "Authorization: Bearer mico_pat_..."

Cualquier cliente MCP que hable Streamable HTTP y te deje definir una cabecera Authorization funciona igual.

Conectar desde claude.ai

El cliente habitual de Claude (web y escritorio) se conecta mediante OAuth en lugar de una cabecera fija:

  1. En claude.ai, ve a Settings → Connectors → Add custom connector y pega la misma URL del endpoint. No hace falta client ID ni secret: el servidor admite el registro dinámico.
  2. Claude abre la página de autorización de Mico. Pega una vez un token de acceso personal (creado en Ajustes → Desarrolladores → MCP) para demostrar que eres tú.
  3. Listo. A partir de ahí, Claude guarda sus propias credenciales de corta duración, que se renuevan solas.

La conexión queda ligada al token que pegaste. Para desconectar a Claude, revoca ese token en Ajustes → Desarrolladores → MCP.

Herramientas

El servidor es de solo lectura: todas las herramientas son idempotentes y no escriben nada:

HerramientaQué devuelve
list_meetingsReuniones recientes, filtrables por fragmento del título o por serie, paginadas
get_meetingUna reunión con su nota, resúmenes, participantes y accionables
get_meeting_transcriptPáginas de transcripción de hasta 500 palabras; sigue pagination.next_offset
get_recurring_meeting_historyLas reuniones de la misma serie recurrente
search_meetingsReuniones cuyo título o resumen contiene un texto
list_pending_action_itemsAccionables abiertos de todas las reuniones, con su reunión
search_shared_notesNotas que otras personas comparten contigo o con tus equipos, por las palabras que contienen
get_shared_noteEl texto de una nota compartida. Solo notas y resúmenes, nunca transcripciones

Las cuatro primeras son las mismas herramientas, con los mismos esquemas, que exponía el servidor local retirado: un agente que ya las conocía no necesita cambios.

Tokens

Los tokens se gestionan en Ajustes → Desarrolladores → MCP: crea tantos como necesites (uno por agente es una buena costumbre), mira cuándo se usó cada uno por última vez y revoca cualquiera al instante. Un token revocado deja de funcionar en la siguiente petición, y con él todas las conexiones OAuth que autorizó.

Consulta la referencia de MCP para ver cada parámetro y error.

¿Qué pasó con el servidor local?

Versiones anteriores incluían un servidor MCP local (mico mcp) que leía la base de datos local de la app de escritorio por stdio. Se retiró en favor del servidor en la nube:

  • El servidor local solo funcionaba en una máquina con la app de escritorio y su base de datos: los agentes de cualquier otro sitio no veían nada.
  • Tus reuniones ya viven, con seguridad a nivel de fila, en los servidores de Mico, que es justo lo que un endpoint MCP alojado puede leer sin guardar una segunda copia en ningún sitio.

La CLI mico no cambia: sigue siendo local y sin conexión, y lee la base de datos de la app de escritorio. Consulta CLI para agentes.