Conectar Claude y otros

Conecta Claude, Codex u otro asistente de IA para que conozcan y gestionen tus datos de Muninn.

Muninn tiene dos formas de hablar con una IA:

Los dos usan las mismas herramientas con las mismas reglas, así que entienden lo mismo. Una vez conectado, puedes pedirle cosas como:

Puedes nombrar los proyectos, las columnas, las cuentas y las categorías por su nombre, sin preocuparte de mayúsculas. Los importes se dicen en euros, como los escribirías tú. Si tienes un proyecto archivado con el mismo nombre que uno activo, se usa el activo. Si hay dos activos que se llaman igual, te pedirá que digas cuál.

Seguridad: el asistente puede crear, editar, mover, completar y archivar, pero nunca borrar nada definitivamente. En el historial de una tarea, lo que hace Claude sale como «Claude» y lo del Asistente de la app, como «El asistente».

Conectar claude.ai

Puedes añadir Muninn como conector en claude.ai: Claude entra con tu cuenta de Muninn y ve lo mismo que tú en la app.

  1. En claude.ai, ve a Ajustes › Conectores y pulsa Añadir conector personalizado.
  2. Ponle un nombre (por ejemplo, Muninn) y pega esta dirección: https://yjzzubpxikpvukymgfkt.supabase.co/functions/v1/mcp
  3. Pulsa conectar. claude.ai te trae a una pantalla de Muninn que dice qué app pide acceso, con qué cuenta entrarás y qué podrá hacer. Si no tenías la sesión abierta, primero te pide entrar. Con el segundo factor activado, también te pide el código de tu app antes de dejarte dar acceso.
  4. Elige Permitir acceso (o Rechazar). Vuelves a claude.ai con el conector listo y sus herramientas.

Un consejo: deja las herramientas de consulta como «permitir siempre» y las que cambian cosas, con «pedir aprobación», para ver qué va a hacer antes de que lo haga.

Ten en cuenta: si usas claude.ai dentro de una organización, quien la administra puede tener que permitir los conectores personalizados. El conector sale de momento con un icono que no es el de Muninn. Los permisos que le das a claude.ai los ves y los quitas en Ajustes › Cuenta › Apps con acceso (Cuenta y seguridad).

Próximamente: usarlo desde la app de Claude en el iPhone. Debería funcionar igual, pero aún no está probado.


Configuración (avanzado)

Esta sección es técnica: se simplificará cuando Muninn incluya un asistente de configuración.

Esto es para conectar un asistente que corre en tu ordenador (Claude Code, Claude Desktop, Codex…) directamente, sin pasar por internet. Compila el servidor una vez desde la carpeta del proyecto:

pnpm --filter @muninn/mcp build

¿Dónde se guardan los datos?

Configuración Dónde
Ninguna En un fichero en tu equipo: ~/.muninn/data.json. Ideal para probar.
MUNINN_DATA_FILE En el fichero que indiques
MUNINN_SUPABASE_URL + MUNINN_SUPABASE_SERVICE_ROLE_KEY + MUNINN_USER_ID En tu cuenta de Muninn en la nube (los mismos datos que ves en la app)

Importante: la service role key da acceso total a la base de datos. Guárdala solo en la configuración de tu equipo y no la compartas nunca.

En los ejemplos, cambia C:/sourcecode/muninn por la carpeta donde tengas Muninn.

Claude Code

claude mcp add muninn --scope user -- node C:/sourcecode/muninn/packages/mcp/dist/index.js

Claude Desktop

Edita %APPDATA%\Claude\claude_desktop_config.json en Windows o ~/Library/Application Support/Claude/claude_desktop_config.json en macOS:

{
  "mcpServers": {
    "muninn": {
      "command": "node",
      "args": ["C:/sourcecode/muninn/packages/mcp/dist/index.js"]
    }
  }
}

Para usar los datos de la nube, añade un bloque "env": { "MUNINN_SUPABASE_URL": "…", … } dentro de "muninn". Después cierra Claude Desktop del todo y vuelve a abrirlo.

Codex

En ~/.codex/config.toml:

[mcp_servers.muninn]
command = "node"
args = ["C:/sourcecode/muninn/packages/mcp/dist/index.js"]

Herramientas disponibles

Para consultar Para actuar
overview: resumen del día create_project
list_projects create_task (con su checklist), create_tasks (hasta 50 a la vez), update_task
project_status: informe de un proyecto move_task, complete_task, archive_task
list_tasks: con filtros add_checklist_item, set_checklist_item_done
get_task: con subtareas y notas create_note (también como hija de otra), update_note, move_note
list_columns, list_notes, recent_activity
list_note_comments: los hilos de una nota o los encargos «Para Claude» comment_on_note, reply_to_comment, resolve_comment (también reabrir)
list_finance_accounts, list_transactions, finance_month_report create_transaction, update_transaction, archive_transaction
list_news, news_digest (con Noticias)
list_finance_categories, list_subscriptions create_finance_account, update_finance_account, archive_finance_account
create_finance_category (las categorías aún no se editan ni se archivan)
create_subscription, record_subscription_charge, skip_subscription_charge, archive_subscription