Servidor MCP

El servidor MCP de FXCode lo sirve la propia CLI: fxc mcp arranca un servidor por stdio que usa la sesión guardada por fxc auth login. No hay tokens que configurar aparte.

Instalar

1. Instala la CLI e inicia sesión.
2. Regístralo en tu cliente.

Claude Code

claude mcp add fxcode --scope user -- fxc mcp

Cursor, Claude Desktop y otros clientes: agrega un servidor stdio en su configuración de MCP:

{
  "mcpServers": {
    "fxcode": { "command": "fxc", "args": ["mcp"] }
  }
}

Para apuntar a otra instalación o usar otra cuenta sin tocar tu sesión, define FXC_API_URL y FXC_TOKEN en el entorno del servidor.

Herramientas

Los estados y las prioridades se pasan por nombre («Working», «Alta»), ignorando mayúsculas y tildes. Las de solo lectura se marcan como tales para que el cliente pueda ejecutarlas sin pedir confirmación.

Herramienta	Qué hace
whoami	El usuario conectado
list_projects	Proyectos a los que tienes acceso (para obtener el projectId)
list_task_options	Estados (cuáles terminan y cuáles animan el progreso) y prioridades
list_tasks	Tareas por proyecto, estado, etiqueta, texto o solo las tuyas; sin las terminadas salvo que las pidas
get_task	Una tarea con su descripción
create_task	Crea una tarea (asignada a ti), con estado, prioridad y etiquetas
update_task	Cambia solo lo que pases: título, descripción, estado, prioridad, etiquetas
add_idea / list_ideas	Anota y lista ideas, sueltas o de un proyecto
promote_idea	Convierte una idea en tarea (una suelta necesita proyecto)
add_note	Guarda una nota en Markdown o HTML
get_architecture	Piezas, conexiones y foco actual del proyecto
import_architecture	Reemplaza la arquitectura (sin credenciales; se valida antes de enviar)
link_task	Enlaza o suelta una tarea de piezas de la arquitectura
focus_pieces / unfocus_pieces	Marca o apaga «un agente está trabajando aquí»
list_requests / get_request	Solicitudes de clientes (correcciones, cambios, ideas), con sus archivos y conversación
respond_request / convert_request	Responder o cambiar el estado; convertir en tarea o idea (se cierra sola al terminar la tarea)
comment_request	Comentar en la conversación con el cliente

La convención de trabajo

Al conectarse, el servidor le explica al agente cómo trabajar para que se vea en FXCode:

1. Al empezar una tarea, la pasa al estado en progreso (por ejemplo «Working») y la enlaza a las piezas de la arquitectura que va a tocar.
2. Si se mete en otra parte del sistema, marca foco en esa pieza.
3. Al terminar, la pasa al estado terminado y quita el foco.
4. Lo que se le ocurra sin compromiso de hacerlo lo anota como idea, no como tarea.

Así, en la arquitectura del proyecto ves en vivo dónde está trabajando cada agente.