MCP y tu propia API

jAIgent se conecta en dos direcciones: hacia fuera como cliente que llama a proveedores, y hacia dentro exponiendo sus herramientas a otros programas. Esta página trata la segunda.

Tu propia API

jaigent serve convierte jAIgent en un endpoint compatible con OpenAI en /v1/chat/completions y /v1/models. Tus aplicaciones reciben una URL; detrás, jAIgent elige el modelo, busca en la web y usa sus herramientas.

jaigent keys new my-app       # imprime jgt-… una sola vez: cópiala ahora
jaigent serve                 # http://127.0.0.1:8787/v1

from openai import OpenAI

client = OpenAI(base_url="http://localhost:8787/v1", api_key="jgt-...")
reply = client.chat.completions.create(
    model="auto",
    messages=[{"role": "user", "content": "investiga X y resúmelo"}],
)
print(reply.choices[0].message.content)
print(reply.jaigent if hasattr(reply, "jaigent") else "")

Las respuestas llevan un bloque jaigent con tool_calls, tools_used y estimated_usd.

[!DANGER] Una clave jgt- es una credencial de producción. Concede acceso completo al agente: archivos, web y shell si lo activaste, facturado a tu cuenta de proveedor. Mantenla en loopback salvo que tengas autenticación real y TLS delante.

MCP por stdio (clientes locales)

Para Claude Desktop y cualquier cliente MCP local:

jaigent mcp --print-config claude     # pega el resultado en Claude Desktop

Expone el registro de herramientas por stdio. Por defecto solo lectura: JAIGENT_MCP_WRITE=1 expone también las herramientas de escritura.

MCP remoto y ChatGPT Web

Esta es la dirección entrante: ChatGPT se conecta a tu host de jAIgent. La vía recomendada es una aplicación MCP remota por Streamable HTTP creada en ChatGPT Web. No es una app stdio local, ni un cliente de sondeo, ni un túnel a la API de OpenAI.

ChatGPT Web → tu proxy inverso HTTPS → `jaigent chatgpt` (`/mcp`, OAuth)
              ├─ herramientas existentes de jAIgent en el espacio configurado
              └─ jaigent_chat / sessions → `jaigent serve` → agente existente

El puente reutiliza el gateway, el registro de herramientas, el sandbox y el almacén de sesiones guardadas de jAIgent. No arranca un segundo agente ni copia credenciales de proveedores. Las escrituras remotas directas siguen pasando por el sandbox del espacio de trabajo y por el almacén de checkpoints existente, sujetos a la política explícita de escritura del puente y del gateway.

Disponibilidad en ChatGPT Web

OpenAI documenta crear una app propia en ChatGPT Web → Settings (o Workspace Settings) → Apps → Create, con Developer Mode y las apps personalizadas activadas. Se introduce el endpoint MCP remoto, se configura OAuth, se escanean las herramientas y se conecta y prueba la app en un chat web.

El plugin de solo escritorio

El listado del plugin de jAIgent es solo de escritorio. Una app MCP/stdio local no es alcanzable desde ChatGPT Web: instalar ese listado no hace que un servidor local sea accesible desde la web. La app remota HTTP/OAuth descrita aquí es una conexión separada.

Los archivos en integrations/chatgpt/ son un arranque opcional para Plugin Creator o Codex, no un servidor alojado ni una forma de saltarse las restricciones de plan de ChatGPT. Nunca se debe describir un plugin como compatible con la web si está marcado como solo escritorio o apunta a un proceso MCP local.

Por qué hace falta un proxy TLS

ChatGPT es el cliente e inicia las peticiones, pero no puede llamar a localhost ni a 127.0.0.1 de tu equipo. jaigent chatgpt enlaza a loopback y sirve HTTP plano: hay que exponerlo por un proxy inverso con TLS, como Caddy, en una URL HTTPS alcanzable públicamente.

Eso requiere tres cosas que jAIgent no proporciona:

1. DNS funcionando.
2. Conectividad entrante.
3. Un servidor de autorización OAuth 2.1 de confianza.

Variables del puente

API de Python

También se puede usar como biblioteca:

from jaigent.agent import Agent

agent = Agent(workspace=".")
result = agent.run("resume README.md")
print(result.text)

El bucle del agente es una función, así que es legible y ampliable sin framework por medio.