FIA Copilot/Documentación
Iniciar sesión

Copiloto FIA Agéntica — conectar tu key

El Copiloto FIA Agéntica es el plugin de Claude Code del programa. Con tu API key de FIA Copilot, el copiloto sabe en qué semana estás y qué te toca, guarda tu bitácora (la de .fia/bitacora.md) en la plataforma y, si te trabás, le avisa a tu CSM.

Quién puede

Cualquier alumno de FIA Agéntica con acceso vigente. No hace falta plan pago de FIA Copilot. Si no tenés plan, tu key sirve sólo para el copiloto (scopes agentica:read y agentica:write): no lee tu memoria ni tus briefings.

Paso a paso

  1. Entrá a Configuración → API Keys.
  2. En Tu usuario de GitHub, poné tu usuario (el de github.com/tu-usuario). Con eso te damos acceso al repositorio del copiloto.
  3. En Crear una API key, ponele de nombre Copiloto FIA y tocá Crear key. Copiala: se muestra una sola vez.
  4. En una terminal, pegá este comando con tu key:
claude mcp add --scope user --transport http fia-copilot https://fiacopilot.com/api/mcp \
  --header "Authorization: Bearer fia_sk_tu_key"

--scope user la deja disponible en cualquier carpeta en la que abras Claude Code (tu Segundo Cerebro, tu app, tu bot).

  1. Abrí Claude Code y escribí /hoy. Si el copiloto te dice en qué semana estás, quedó conectado.

Para cortar el acceso, revocá la key en la misma pantalla.

Para el plugin. Si el plugin declara el MCP en su propio .mcp.json, la key no se escribe ahí: se lee de la variable de entorno FIA_COPILOT_API_KEY ("Authorization": "Bearer ${FIA_COPILOT_API_KEY}"). Verificar la expansión de variables en plugins en Windows y Mac antes de publicarlo.

Herramientas del copiloto

Todas actúan sólo sobre tus datos.

Tool Qué hace Scope
mi_estado Semana liberada, semana real, atraso, cápsulas pendientes de la semana, próximo evento en vivo y resumen de tu bitácora agentica:read
list_capsules Las cápsulas que ves en la plataforma (mismas reglas de acceso y de goteo semanal) agentica:read o memory:read
my_progress Tu progreso por cápsula agentica:read o memory:read
registrar_bitacora Guarda el estado de tu bitácora (semana, proyecto, tareas, trabas, ánimo, próximo paso, zanahoria, última sesión) agentica:write
marcar_progreso Marca una cápsula como completada agentica:write o memory:write
pedir_ayuda Le avisa a tu CSM en privado; si lo pedís, además publica en Feedback y ayuda de la comunidad agentica:write

Equivalentes REST (base https://fiacopilot.com/api/v1):

Método Ruta Igual que
GET /agentica/estado mi_estado
GET /agentica/bitacora (lee la bitácora guardada)
PUT /agentica/bitacora registrar_bitacora
POST /capsules/progress marcar_progreso
POST /agentica/ayuda pedir_ayuda

mi_estado

Sin parámetros. Devuelve:

{
  "alumno": { "nombre": "Ana", "email": "ana@…" },
  "acceso": { "tier": "standard", "alta": "2026-10-10T…", "inicio_cohorte": null, "vence": "2027-03-10T…" },
  "semana_liberada": 4,
  "proxima_liberacion": { "semana": 5, "fecha": "2026-11-07" },
  "semana_real": 3,
  "semana_real_fuente": "bitacora",
  "atraso_semanas": 1,
  "semana_foco": 3,
  "pendientes_semana": [ { "id": "…", "slug": "…", "titulo": "…", "semana": 3, "minutos": 20, "url": "https://fiacopilot.com/pasos?path=fia-agentica&cap=…" } ],
  "progreso_semana": { "completadas": 2, "total": 5 },
  "pendientes_hasta_semana_liberada": 7,
  "proximo_evento": { "nombre": "Clase en vivo FIA Agéntica", "fecha": "2026-11-05T21:30:00Z", "termina": "…", "zona_horaria": "America/Argentina/Buenos_Aires", "descripcion": null, "url": "https://fiacopilot.com/comunidad/calendario" },
  "bitacora": { "ultima_sesion_at": "…", "trabas_abiertas": 1, "dias_traba_mas_vieja": 2, "proximo_paso": "…", "animo": 3 },
  "url_plataforma": "https://fiacopilot.com/pasos?path=fia-agentica",
  "hoy": "2026-10-31"
}
  • Semana liberada: semanas 0 y 1 el día del alta; la semana N a los (N−1)×7 días (desde el inicio de la cohorte si existe). Tope 8.
  • Semana real: la semana_actual de tu bitácora; si nunca sincronizaste, la semana más alta con una cápsula completada.
  • bitacora es null si todavía no sincronizaste.

registrar_bitacora

Recibe lo que el copiloto leyó de .fia/bitacora.md. Sólo semana_actual es obligatorio; lo demás reemplaza el estado anterior. Las trabas que llegan sin fecha conservan la fecha en que se vieron por primera vez.

{
  "semana_actual": 3,
  "etapa": "programa",
  "ciclo_continuidad": 0,
  "nivel": "principiante",
  "plan_claude": "Pro",
  "fecha_acceso": "2026-10-10",
  "proyecto": { "proceso": "…", "idea_grande": "…", "version_minima": "…", "queda_afuera": "…", "hecho_demo_day": "…" },
  "proximo_paso": "Conectar Supabase — Hecho cuando: la tabla clientes tiene 3 filas",
  "zanahoria": { "hoy": "…", "en_8_semanas": "…", "en_6_meses": "…", "para_que": "…", "logrado": "…" },
  "tareas_hechas": [ { "semana": 2, "texto": "Repo creado y primer deploy" } ],
  "trabas_abiertas": [ { "fecha": "2026-10-29", "semana": 3, "texto": "El MCP figura conectado pero no responde", "pedido_ayuda": "no" } ],
  "animo": { "fecha": "2026-10-31", "puntaje": 3, "texto": "cansado pero avanzando" },
  "ultima_sesion": { "fecha": "2026-10-31", "comando": "/hoy", "resumen": "Arrancó la semana 3" },
  "bitacora_md": "(opcional) el archivo completo",
  "formato_bitacora": 1
}

Devuelve { ok, semana_actual, semana_liberada, atraso_semanas, trabas_abiertas, dias_traba_mas_vieja, sesiones_registradas }.

No mandes credenciales, claves ni datos de clientes: la bitácora la lee tu CSM.

marcar_progreso

{ "capsule_id": "…" } o { "slug": "…" }. Sólo cápsulas que ves en la plataforma. Devuelve { ok, ya_estaba_completa, capsula: { id, slug, titulo, semana, url } }. Errores: capsule_not_found_or_locked, capsule_locked.

pedir_ayuda

{
  "mensaje": "Hace 2 horas que el MCP de Supabase figura conectado pero no trae datos",
  "titulo": "MCP de Supabase no responde",
  "semana": 3,
  "contexto": { "que_intente": "reinstalé, reinicié VS Code", "error": "…", "sistema": "Windows 11" },
  "publicar_en_comunidad": false
}
  • Por defecto es privado: queda registrado y le llega un aviso a tu CSM (en la campana de FIA Copilot). Sin mail ni WhatsApp por ahora.
  • Con publicar_en_comunidad: true además se publica un post a tu nombre en Feedback y ayuda.
  • Máximo 5 pedidos por día.

Devuelve { ok, pedido_id, canal: "csm" | "comunidad", avisados, post_url }.

Errores

Error Qué significa
subscription_required (402) No tenés plan pago ni acceso vigente a FIA Agéntica
insufficient_scope La key no tiene el scope (las keys de alumno sin plan sólo tienen agentica:*)
agentica_access_required Tu acceso a FIA Agéntica venció o es de prueba (preview)
rate_limited Más de 30 escrituras o 120 lecturas por minuto con la misma key