Conecta tu asistente de IA

Astromicelio habla MCP, el protocolo abierto con el que un asistente de IA se conecta a herramientas. Conectas el tuyo con tu cuenta y le pides las cosas en tus palabras: que te liste tus identidades, que te dé una carta con sus posiciones y aspectos, que lea un estudio entero y lo interprete, que escriba una nota donde corresponde.

Usa la suscripción de tu asistente, la que ya pagas. Astromicelio no cobra tokens ni guarda tus conversaciones con el modelo.

Calcula, no interpreta

El servidor entrega los datos: posiciones con signo, grado y casa, aspectos con su orbe y cuánto les falta para ser exactos, balance de elementos y modalidades, el regente del Ascendente. La lectura la pone tu asistente. Es el reparto que hace que esto sirva: Astromicelio no tiene una tabla de significados, y un asistente no puede levantar efemérides.

Qué puedes pedirle

Identidades

Listar las personas de tu cuenta, leer los datos de nacimiento de una, crear una nueva —basta la ciudad y el país, las coordenadas se buscan solas—, corregir una fecha o una hora, mandar una a la papelera. Y buscar en todo a la vez: notas, identidades, estudios, eventos, núcleos y comentarios.

  • list_identities
  • get_identity
  • create_identity
  • update_identity
  • trash_identity
  • list_identity_folders
  • list_identity_categories
  • search

Cartas

El detalle de una carta natal, del cielo de un día contra esa carta, o de la revolución solar de un año: posiciones, casas, aspectos con orbe y exactitud, y los balances. También la sinastría entre dos personas y el barrido de tránsitos de una ventana de fechas, que es lo que responde «¿qué estaba pasando cuando pasó aquello?». Y los hitos del ciclo vital de una persona —retornos de Saturno y Júpiter, retornos nodales, las cuadraturas de Neptuno y Plutón—, calculados con su carta y con sus pases exactos.

  • get_chart
  • get_synastry
  • get_davison
  • scan_transits
  • cast_chart
  • get_milestones
  • get_account_frame

Cielo

Las lunaciones, los eclipses, los ingresos y las estaciones del año, y los aspectos exactos entre Júpiter y los lentos; y, para cada evento, en qué casa y contra qué puntos le cae a una identidad. En UT y en zodiaco trópico, como en /app/sky.

  • list_sky_events
  • sky_event_impact
  • get_ephemeris_month

Numerología

Los números de una identidad: camino de vida, expresión, alma, personalidad, pináculos, desafíos y el ciclo personal de un día. Cada número llega con su suma sin reducir y sus pasos de reducción, y con la convención con la que se calculó. El servidor no interpreta: los significados los pones tú.

  • get_numerology

Diseño humano

El gráfico de Human Design de una identidad: las 26 activaciones de personalidad y de diseño con su puerta y su línea, los canales y centros definidos, y el tipo, la autoridad, el perfil, la definición y la cruz. Sin hora de nacimiento no hay tipo ni perfil, y la respuesta lo dice. El servidor no interpreta: los significados los pones tú.

  • get_human_design

Cohortes

Agrupa tus identidades por generación, por década o por planeta lento en signo —quiénes de los tuyos tienen Plutón en Escorpio— y lista los miembros de cada cohorte. Pertenencias calculadas, nunca interpretadas.

  • list_cohorts
  • get_cohort_members
  • list_cohort_notes
  • upsert_cohort_note

Estudios

Un caso entero en una sola llamada: cada miembro con su carta, sus notas y sus eventos, la sinastría entre cada par y el balance del grupo. Es la herramienta para pedir una lectura del conjunto y no de una carta suelta.

  • list_studies
  • get_study
  • get_study_bundle
  • create_study
  • add_study_member
  • remove_study_member
  • trash_study

Relaciones

El grafo familiar de una persona con el parentesco ya calculado: abuelas, tíos, primos y medios hermanos salen de las filas de filiación sin que nadie los haya escrito. También declarar una filiación, una pareja o un vínculo que no es de familia.

  • get_family_graph
  • add_parent_child
  • add_family_union
  • add_bond
  • remove_relation

Eventos

Lo que le pasó a alguien y cuándo. Sin la biografía, un tránsito exacto es una fecha sin historia, así que esto es la otra mitad de cualquier lectura de tránsitos.

  • list_events
  • create_event
  • update_event
  • delete_event

Eventos globales y líneas de tiempo

Lo que le pasó al mundo y no a alguien: el catálogo común de eventos globales, con sus fechas y categorías, y tus líneas de tiempo, que son curaciones tuyas de ese catálogo. Puedes leerlas, crear una y añadir o quitar eventos; el catálogo en sí no se edita desde aquí.

  • list_timelines
  • list_global_events
  • get_global_event
  • create_timeline
  • add_timeline_events
  • remove_timeline_events

Notas

Leer y escribir las notas ancladas a una posición de la carta. Una nota escrita desde el asistente aparece al pinchar esa posición en la rueda, porque usa las mismas claves que la aplicación. También leer y escribir en el hilo de comentarios de una nota, con el mismo aviso a quienes la ven.

  • list_notes
  • get_note
  • upsert_note
  • delete_note
  • list_note_comments
  • add_note_comment
  • list_note_tags

Los tres alcances

Cada token lleva los alcances que le des, y no son acumulativos: uno de escritura no puede borrar. Tu asistente solo ve las herramientas que su token alcanza, así que lo que no le des ni siquiera se le ofrece.

read — Lectura
Listar y leer: identidades, estudios, cartas, relaciones, eventos, líneas de tiempo y notas. No escribe nada.
write — Escritura
Crear y modificar: identidades, estudios, relaciones, eventos, líneas de tiempo y notas.
destructive — Borrado
Mandar a la papelera una identidad o un estudio, y borrar un evento, una nota, una relación o un evento de una línea de tiempo. Dalo solo si de verdad quieres que tu asistente pueda.

Cómo conectar

  1. 1. Elige cómo autorizar

    Claude —web, escritorio y móvil— se autoriza con tu cuenta: pegas la dirección, aceptas en una pantalla de Astromicelio y no hay token que copiar. Claude Code, Cursor y Codex usan un token personal: créalo en tu cuenta, sección «Asistentes de IA», elige los alcances y cópialo, porque se muestra una sola vez.

  2. 2. Esta es la dirección

    La del servidor MCP de este despliegue. Termina en /api/mcp.

  3. 3. Conecta tu cliente

    Busca el tuyo abajo. Cada bloque es el formato que ese cliente lee de verdad: uno de otro cliente conecta y no enseña ninguna herramienta.

Crear un token

https://astromicelio.devenirmovimiento.es/api/mcp

Claude: web, escritorio y móvil

Ajustes → Conectores → Añadir conector personalizado. Pega esta dirección, sin nada más, y pulsa Conectar: se abre una pantalla de Astromicelio donde eliges qué puede hacer Claude y autorizas. Lo que añadas en la web aparece también en el escritorio y en el móvil.

https://astromicelio.devenirmovimiento.es/api/mcp

Claude Code

En la terminal. Un comando y listo; `claude mcp list` confirma que dice «Connected». Si prefieres no copiar un token, quita las dos líneas `--header` y autoriza con `/mcp` dentro de Claude Code.

claude mcp add --transport http astromicelio https://astromicelio.devenirmovimiento.es/api/mcp \
  --header "Authorization: Bearer amc_TU_TOKEN" \
  --header "x-astromicelio-locale: es"

Cursor

En `~/.cursor/mcp.json` (para todos tus proyectos) o `.cursor/mcp.json` (para uno). Cursor no lleva `type` para un servidor remoto.

{
  "mcpServers": {
    "astromicelio": {
      "url": "https://astromicelio.devenirmovimiento.es/api/mcp",
      "headers": {
        "Authorization": "Bearer amc_TU_TOKEN",
        "x-astromicelio-locale": "es"
      }
    }
  }
}

Codex

En `~/.codex/config.toml`. El token no va en el archivo: va en la variable de entorno que nombra `bearer_token_env_var`, así que antes exporta `ASTROMICELIO_MCP_TOKEN=amc_TU_TOKEN` en la terminal desde la que abres Codex.

[mcp_servers.astromicelio]
url = "https://astromicelio.devenirmovimiento.es/api/mcp"
bearer_token_env_var = "ASTROMICELIO_MCP_TOKEN"
http_headers = { "x-astromicelio-locale" = "es" }

Archivo .mcp.json

El formato del `.mcp.json` de un proyecto de Claude Code, que otros clientes copian. Úsalo si tu cliente pide un JSON con `type`.

{
  "mcpServers": {
    "astromicelio": {
      "type": "http",
      "url": "https://astromicelio.devenirmovimiento.es/api/mcp",
      "headers": {
        "Authorization": "Bearer amc_TU_TOKEN",
        "x-astromicelio-locale": "es"
      }
    }
  }
}

En el navegador: WebMCP

Si tu navegador trae un agente de IA —Gemini en Chrome, o una extensión—, Astromicelio le puede ofrecer herramientas desde la propia pestaña. No hace falta token: el agente trabaja con tu sesión, sobre lo que tienes abierto, y con los mismos permisos que tú en pantalla.

Hoy solo lo trae Chrome, en pruebas: actívalo en chrome://flags/#enable-webmcp-testing. Después enciéndelo en tu cuenta, en «Asistentes de IA», apartado «En este navegador». Está apagado por defecto y vale solo para ese dispositivo.

En cualquier pantalla

  • list_identities
  • list_studies
  • search
  • open_in_app

Con una identidad abierta

  • get_open_identity
  • describe_open_chart
  • describe_open_transits
  • scan_open_transits
  • get_open_solar_return
  • list_open_sky_events
  • get_open_milestones
  • get_open_human_design
  • get_open_numerology
  • list_open_notes
  • list_open_events
  • get_open_relations
  • write_note

Con un estudio abierto

  • get_open_study
  • get_open_study_synastry

Una sola escritura, write_note, y te pide confirmación en pantalla antes de guardar. No puede borrar, mandar a la papelera, compartir, hacer pública una identidad ni crear tokens.

WebMCP es un borrador de especificación y puede cambiar. Si tu navegador no lo trae, no pasa nada: la aplicación funciona igual.

Cosas que puedes decirle

  • «Lista mis identidades y dime cuáles no tienen hora de nacimiento.»
  • «Dame la carta natal de Ana con detalle completo e interprétamela.»
  • «¿Qué tránsitos tenía Ana entre marzo de 2019 y marzo de 2020? Crúzalos con sus eventos de esos años.»
  • «Léete el estudio «Familia materna» entero y dime qué se repite entre las tres generaciones.»
  • «Compara la carta de Ana con la de Marta y dime dónde se tocan.»
  • «Escribe una nota sobre el Sol en casa 10 de Ana con lo que acabamos de hablar.»

Cuando no conecta

Conecta pero no aparece ninguna herramienta.
El token no está llegando. Comprueba que la cabecera se llama Authorization y que su valor es «Bearer amc_…» con el token entero. Con Codex, que `bearer_token_env_var` lleve el nombre de la variable y no el token, y que la variable esté exportada en la terminal desde la que lo abres.
Claude dice que no pudo conectar o que falló la autorización.
Comprueba que pegaste la dirección que termina en /api/mcp, sin cabeceras ni token, y que en la pantalla de Astromicelio pulsaste «Autorizar» con la cuenta donde están tus datos. Si cerraste esa pantalla, vuelve a pulsar Conectar.
Aparecen unas herramientas pero no las que necesito.
El token o la autorización no tienen ese alcance. Uno de solo lectura no ve las de escritura: se le ocultan a propósito, para que no te las pidan. Crea otro token, o desconecta y vuelve a autorizar marcando el alcance que falte.
El asistente dice que no encuentra a esa persona.
Necesita el identificador, no el nombre. Pídele primero que liste tus identidades; a partir de ahí ya sabe cuál es cuál.
La dirección devuelve 404.
Falta la parte final: el servidor está en /api/mcp, no en /mcp, que es esta página.
Las categorías y los rótulos salen en español.
El servidor contesta en español si nadie le dice otra cosa. Los bloques de esta página ya llevan la cabecera x-astromicelio-locale con tu idioma; si configuraste el cliente a mano, añádela.
La carta sale sin casas.
Esa identidad no tiene hora de nacimiento. Sin ella no hay casas ni ángulos, y el servidor prefiere decirlo a darte las casas de un mediodía que nadie eligió.

Los límites, y lo que nunca es una herramienta

  • Un token no da más de lo que tú ya puedes: pasa por la misma capa de permisos que la aplicación.
  • Alcanza también lo que otras personas te compartieron en un estudio, incluidas sus notas y sus datos de nacimiento. Es lo que ves en pantalla, pero un asistente puede volcarlo entero en una conversación con un proveedor externo. Tenlo presente al elegir qué conectas.
  • No hay herramienta para compartir, ni para hacer pública una identidad, ni para crear enlaces: ceder los datos de nacimiento de otra persona quiere una pantalla delante.
  • Tampoco para la facturación, la administración ni el borrado definitivo.
  • Un token, o una conexión autorizada desde Claude, se revoca desde tu cuenta y deja de valer en la siguiente llamada.