Clientes externos

APX también es un servidor MCP. Registrá apx mcp en Claude Code, Codex o cualquier otro cliente MCP, y esa app puede preguntarles cosas a tus agentes de APX y manejar el navegador integrado de APX.

Qué recibe el cliente

apx mcp es un servidor MCP por stdio que reenvía al core que está corriendo. Lo que ofrece depende del token con el que arranca:

Arranca con	Tools
Sin token	`browser_*`: tabs, open, navigate, snapshot, click, type, screenshot, text, history, handoff, close
Un token con alcance Chat	`apx_agents`, `apx_ask`, `apx_read`
Un token con Chat y Navegador	Los dos grupos

apx_agents lista tus agentes.
apx_ask le pregunta a uno y espera la respuesta hasta 5 minutos. Pasale el thread que devuelve para seguir el chat.
apx_read lee un chat que empezó el cliente.

Las tools del navegador necesitan la app de escritorio de APX abierta, porque el navegador es de ella. Los campos de contraseña, código de un solo uso y tarjeta se rechazan: browser_handoff te pasa la pestaña para que inicies sesión vos.

Creá un token

Cada app tiene su propio token. Se muestra una sola vez; APX guarda solo una huella.

Panel
Terminal

En Configuración › Tokens de API, escribí un Nombre de la app, marcá Chat y/o Navegador, y tocá Crear token. Copialo enseguida. Cada token muestra cuándo se usó por última vez, y Revocar lo quita.

Configuración, Tokens de API: una lista de tokens de apps con sus alcances y último uso, y un formulario para crear uno nuevo — Configuración › Tokens de API

apx clients add claude-code                    # alcance chat
apx clients add codex --scopes chat,browser
apx clients                                    # lista, con el último uso
apx clients rm <id>                            # revocar

Registrá APX en tu cliente

claude mcp add apx --scope user -e APX_CLIENT_TOKEN=<token> -- apx mcp
claude mcp add apx-browser --scope user -- apx mcp        # solo navegador, sin token
claude mcp list

--scope user lo deja disponible en todos los proyectos.

codex mcp add apx --env APX_CLIENT_TOKEN=<token> -- apx mcp
codex mcp list

{
  "command": "apx",
  "args": ["mcp"],
  "env": { "APX_CLIENT_TOKEN": "<token>" }
}

Si apx no está en el PATH del cliente, usá la ruta completa que imprime command -v apx. Para un core en otro puerto u otra máquina, sumá también APX_URL al entorno.

Después simplemente pedí, por ejemplo en Claude Code: “preguntale a mi secretaria de APX qué vence esta semana”. O, con el alcance de navegador: “abrí el admin de Acme Store en el navegador de APX y fijate los pedidos de hoy”.

Enseñale APX al cliente

APX copia unas skills en Claude Code, Codex, Cursor y ~/.agents cada vez que arranca, así esas apps saben usar apx y estas tools. Mirá Skills.

Cuando las tools no aparecen

Corré apx status: ¿el core está andando?
Corré apx mcp en una terminal. Debería quedarse esperando en silencio (Ctrl-C para salir). Cualquier error ahí es el real.
Solo tools de navegador, sin apx_*: falta el token o fue revocado (apx clients).
Token pero sin tools de navegador: sus alcances dejan afuera el navegador (--scopes chat,browser).
Las llamadas al navegador fallan como no disponibles: la app de escritorio no está abierta.