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.

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

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
  • scan_transits
  • cast_chart
  • get_milestones

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

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

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

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.

  • list_notes
  • get_note
  • upsert_note
  • delete_note

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 y notas. No escribe nada.
write — Escritura
Crear y modificar: identidades, estudios, relaciones, eventos y notas.
destructive — Borrado
Mandar a la papelera una identidad o un estudio, y borrar un evento, una nota o una relación. 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_milestones
  • 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.