JustOneAPI MCP Server

简体中文 | English

Usa JustOneAPI en clientes MCP como ChatGPT, Codex, Cursor, Hermes Agent y otras herramientas de asistente de IA.

JustOneAPI MCP ayuda a tu asistente a encontrar el endpoint correcto de JustOneAPI, inspeccionar los parámetros necesarios y llamar a las API mediante tu autorización de JustOneAPI.

Clientes compatibles

JustOneAPI MCP admite HTTP Streamable remoto y stdio local. Las rutas actuales verificadas y de compatibilidad incluyen:

• Conexiones MCP del modo desarrollador de ChatGPT web: OAuth, verificado.

• Codex CLI y la extensión de Codex para IDE: OAuth, verificado.

• Cursor, Hermes Agent y otros clientes con cabeceras personalizadas: método de compatibilidad con el API Token existente.

• Claude.ai, Claude Desktop y Claude Code: OAuth sigue en pruebas de compatibilidad; Claude Code puede usar una cabecera de API Token existente.

Los clientes con un flujo de registro OAuth compatible pueden conectarse solo con la URL remota y completar la autorización en el navegador. La compatibilidad también depende del soporte de registro del cliente y de la política de la cuenta o del espacio de trabajo. Los clientes sin OAuth pueden seguir usando una cabecera de API Token heredada o stdio local.

Related MCP server: MCP from API

Inicio rápido

HTTP remoto con OAuth

OAuth está habilitado en el servicio de producción. Añade esta URL como conexión MCP:

https://mcp.justoneapi.com/mcp

Los clientes compatibles descubren los metadatos del recurso protegido, te redirigen a auth.justoneapi.com y solicitan los ámbitos MCP que se muestran en la página de consentimiento. No es necesario pegar ningún API Token de JustOneAPI en el cliente. Los puntos de entrada, los métodos de registro OAuth y las restricciones de cuenta varían según el cliente, por lo que la configuración siguiente solo enumera rutas OAuth verificadas.

Configuración del cliente

• ChatGPT web: abre Settings → Security and login, activa Developer mode, abre Plugins y selecciona +. Introduce un nombre, una descripción y la URL /mcp anterior, y elige OAuth para Autenticación. Tras crear la conexión, ChatGPT descubre los metadatos de autenticación e inicia la autorización durante la conexión o cuando se invoca por primera vez una herramienta protegida. La disponibilidad del modo desarrollador puede depender de la cuenta de ChatGPT y de la política del espacio de trabajo.

• Codex CLI / extensión de IDE: ejecuta los comandos siguientes. La configuración recomendada actualmente usa explícitamente la ruta de registro DCR verificada:

codex mcp add justoneapi \
  --url https://mcp.justoneapi.com/mcp

codex mcp login justoneapi \
  --oauth-client-registration dcr

La aplicación de escritorio de ChatGPT, Codex CLI y la extensión de Codex para IDE comparten la configuración MCP en el mismo host de Codex. Consulta la documentación oficial de MCP de OpenAI y la guía de prueba de conexión de ChatGPT para conocer los puntos de entrada actuales.

El OAuth para Claude.ai, Claude Desktop y Claude Code sigue en pruebas de compatibilidad y aún no se ofrece como conexión OAuth con soporte general. Claude Code puede usar un API Token existente con --header "Authorization: Bearer your_token"; no trates el JSON genérico siguiente como una configuración de Claude Code.

La página de autorización muestra los ámbitos solicitados. El propietario de una cuenta selecciona un API Token existente o crea uno dedicado; un Token Member solo puede usar el Token asignado a ese miembro. Desconectar la aplicación más tarde revoca únicamente su conexión OAuth; no deshabilita ni elimina el API Token vinculado.

HTTP remoto con un API Token existente

La conexión existente basada en cabeceras sigue siendo compatible:

{
  "mcpServers": {
    "justoneapi": {
      "url": "https://mcp.justoneapi.com/mcp",
      "headers": {
        "Authorization": "Bearer your_token"
      }
    }
  }
}

stdio local

A fecha de 2026-08-25, npm latest sigue siendo el paquete heredado 1.0.1, no la implementación v2 de este repositorio. Si necesitas stdio local, fija la versión para que la CLI heredada no se confunda con el servicio v2 alojado:

{
  "mcpServers": {
    "justoneapi": {
      "command": "npx",
      "args": ["-y", "justoneapi-mcp@1.0.1"],
      "env": {
        "JUSTONEAPI_TOKEN": "your_token"
      }
    }
  }
}

La versión heredada 1.0.1 es compatible con Node.js 18 o superior, y su disposición de herramientas no es la misma que la del servicio v2 alojado. OAuth se aplica solo al Worker remoto; stdio sigue leyendo JUSTONEAPI_TOKEN localmente. Actualiza esta guía de versiones después de que v2 se publique realmente en un dist-tag de npm.

Las compilaciones de catálogo y los lanzamientos dinámicos usan validación de seguridad pública integrada y no requieren registro de seguridad ni secreto del operador. Las llamadas de API y de cuenta en tiempo de ejecución devuelven el payload del upstream sin truncamiento de respuesta en la capa MCP.

Autenticación y ámbitos

Los usuarios de OAuth seleccionan el API Token que quieren vincular en la página de autorización y no lo pegan en el cliente. El método de compatibilidad remota con API Token existente usa:

Authorization: Bearer your_token

o, para stdio local:

JUSTONEAPI_TOKEN=your_token

El stdio local usa la variable de entorno anterior. Nunca confirmes un Token real en un repositorio.

Los tokens de acceso OAuth usan tres ámbitos de privilegio mínimo:

• mcp:catalog:read — buscar endpoints, inspeccionar esquemas y listar plataformas.

• mcp:api:call — llamar a un endpoint de JustOneAPI.

• mcp:account:read — ver saldo y uso.

call_endpoint puede generar cargos según el API Token vinculado durante OAuth y su precio, permisos, saldo y presupuesto actuales. Valida el endpoint y los parámetros antes de obtener un token de delegación de corta duración y, a continuación, realiza exactamente un envío ascendente. No reintenta automáticamente un tiempo de espera incierto, un fallo de red o un resultado HTTP 502/503/504.

Los API Tokens heredados se siguen enviando al backend de JustOneAPI en el formato de consulta/formulario establecido. Los tokens de acceso y delegación de OAuth nunca se incluyen en las URL del backend ni en los cuerpos de formulario; los tokens de delegación se envían solo como cabecera Authorization Bearer.

Despliegue para operadores

La producción se ejecuta actualmente en modo dual. OAuth es aditivo y está controlado por características, y estos interruptores siguen siendo el límite de despliegue y reversión:

• JUSTONEAPI_OAUTH_MODE=off mantiene el servicio remoto solo con el método heredado y oculta los metadatos de descubrimiento de OAuth.

• JUSTONEAPI_OAUTH_MODE=dual acepta tanto API Tokens existentes como OAuth estándar en el origen exacto https://mcp.justoneapi.com.

• Las rutas de vista previa y workers.dev siguen siendo solo con el método heredado, incluso si la variable está configurada como dual.

El Worker usa private_key_jwt para la introspección del servidor de autorización y el intercambio de tokens RFC 8693. Almacena el conjunto JWK privado y el kid activo como secretos del Worker; nunca confirmes .dev.vars, archivos PEM ni conjuntos JWK privados. Rota las claves publicando primero las claves públicas antigua y nueva, cambiando después el kid activo y eliminando la clave retirada solo después del período de solapamiento.

npm 2.0 se publicará primero bajo el dist-tag next mediante publicación de confianza OIDC. Después de que el artefacto publicado exacto supere las pruebas de humo de Node.js 20, 22 y 24, un operador lo promociona por separado con 2FA de npm usando npm dist-tag add justoneapi-mcp@2.0.0 latest. Esto nunca se automatiza con un NPM_TOKEN. Consulta RELEASE.md.

Cosas que puedes preguntar

Pregunta a tu cliente MCP de forma natural:

Find the Xiaohongshu note comments API and tell me which parameters are required.

Más ejemplos:

Which Douyin APIs can get video details?

Call the Xiaohongshu note comments API with this note ID: xxxxx.

List the Weibo search-related APIs and explain when to use each one.

Continue to the next page of results.

Check my JustOneAPI balance.

Show my recent API usage and spending.

The API returned code 400. Help me check which parameter might be wrong.

The API returned code 601 or 602. What does it mean?

El asistente puede buscar endpoints disponibles de JustOneAPI, explicar los parámetros necesarios, llamar a la API seleccionada después de que proporciones los valores requeridos y ayudar a interpretar los códigos de respuesta comunes.

Licencia

MIT