JustOneAPI MCP Server

简体中文 | English

Verwenden Sie JustOneAPI in MCP-Clients wie ChatGPT, Codex, Cursor, Hermes Agent und anderen KI-Assistenten-Tools.

JustOneAPI MCP hilft Ihrem Assistenten, den richtigen JustOneAPI-Endpunkt zu finden, die erforderlichen Parameter zu prüfen und APIs über Ihre JustOneAPI-Autorisierung aufzurufen.

Unterstützte Clients

JustOneAPI MCP unterstützt entferntes Streamable HTTP und lokales stdio. Die derzeit verifizierten und Kompatibilitätspfade umfassen:

• ChatGPT-Web-MCP-Verbindungen im Entwicklermodus: OAuth, verifiziert.

• Codex-CLI und die Codex-IDE-Erweiterung: OAuth, verifiziert.

• Cursor, Hermes Agent und andere Clients mit benutzerdefinierten Headern: bestehende API-Token-Kompatibilitätsmethode.

• Claude.ai, Claude Desktop und Claude Code: OAuth befindet sich weiterhin in Kompatibilitätstests; Claude Code kann einen vorhandenen API-Token-Header verwenden.

Clients mit einem kompatiblen OAuth-Registrierungsablauf können sich allein mit der Remote-URL verbinden und die Autorisierung im Browser abschließen. Die Kompatibilität hängt auch von der Unterstützung der Client-Registrierung und der Konto- oder Workspace-Richtlinie ab. Clients ohne OAuth können weiterhin einen Legacy-API-Token-Header oder lokales stdio verwenden.

Related MCP server: MCP from API

Schnellstart

Remote-HTTP mit OAuth

OAuth ist im Produktionsdienst aktiviert. Fügen Sie diese URL als MCP-Verbindung hinzu:

https://mcp.justoneapi.com/mcp

Kompatible Clients erkennen die Metadaten der geschützten Ressource, leiten Sie zu auth.justoneapi.com weiter und fragen nach den auf der Zustimmungsseite angezeigten MCP-Scopes. Es muss kein JustOneAPI-API-Token in den Client eingefügt werden. Einstiegspunkte, OAuth-Registrierungsmethoden und Kontoeinschränkungen variieren je nach Client, daher listet die folgende Einrichtung nur verifizierte OAuth-Pfade auf.

Client-Einrichtung

• ChatGPT-Web: Öffnen Sie Settings → Security and login, aktivieren Sie Developer mode, öffnen Sie Plugins und wählen Sie +. Geben Sie einen Namen, eine Beschreibung und die oben genannte /mcp-URL ein und wählen Sie dann OAuth für die Authentifizierung. Nach dem Erstellen der Verbindung erkennt ChatGPT die Authentifizierungsmetadaten und startet die Autorisierung während der Verbindung oder beim ersten Aufruf eines geschützten Tools. Die Verfügbarkeit des Entwicklermodus kann vom ChatGPT-Konto und der Workspace-Richtlinie abhängen.

• Codex-CLI / IDE-Erweiterung: Führen Sie die folgenden Befehle aus. Die derzeit empfohlene Einrichtung verwendet explizit den verifizierten DCR-Registrierungspfad:

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

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

Die ChatGPT-Desktop-App, die Codex-CLI und die Codex-IDE-Erweiterung teilen sich die MCP-Konfiguration auf demselben Codex-Host. Aktuelle Einstiegspunkte finden Sie in der offiziellen OpenAI-MCP-Dokumentation und im Leitfaden zum Testen der ChatGPT-Verbindung.

OAuth für Claude.ai, Claude Desktop und Claude Code befindet sich weiterhin in Kompatibilitätstests und wird noch nicht als allgemein unterstützte OAuth-Verbindung angeboten. Claude Code kann einen vorhandenen API-Token mit --header "Authorization: Bearer your_token" verwenden; behandeln Sie das folgende generische JSON nicht als Claude-Code-Konfiguration.

Die Autorisierungsseite zeigt die angeforderten Scopes. Ein Kontoinhaber wählt einen vorhandenen API-Token aus oder erstellt einen dedizierten; ein Token-Mitglied kann nur den diesem Mitglied zugewiesenen Token verwenden. Wenn die App später getrennt wird, wird nur ihre OAuth-Verbindung widerrufen; der verknüpfte API-Token wird nicht deaktiviert oder gelöscht.

Remote-HTTP mit einem vorhandenen API-Token

Die bestehende headerbasierte Verbindung wird weiterhin aus Kompatibilitätsgründen unterstützt:

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

Lokales stdio

Stand 2026-08-25 ist npm latest weiterhin das Legacy-Paket 1.0.1, nicht die v2-Implementierung in diesem Repository. Wenn Sie lokales stdio benötigen, pinnen Sie die Version, damit die Legacy-CLI nicht mit dem gehosteten v2-Dienst verwechselt wird:

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

Legacy 1.0.1 unterstützt Node.js 18 oder neuer, und sein Tool-Layout ist nicht dasselbe wie beim gehosteten v2-Dienst. OAuth gilt nur für den Remote-Worker; stdio liest weiterhin JUSTONEAPI_TOKEN lokal. Aktualisieren Sie diese Versionsanleitung, nachdem v2 tatsächlich mit einem npm-dist-tag veröffentlicht wurde.

Katalog-Builds und dynamische Releases verwenden eine integrierte Public-Safety-Validierung und benötigen kein Operator-Sicherheitsregister und kein Geheimnis. Laufzeit-API- und Kontenaufrufe geben die Upstream-Payload ohne Antwortkürzung auf MCP-Ebene zurück.

Authentifizierung und Scopes

OAuth-Benutzer wählen auf der Autorisierungsseite den zu verknüpfenden API-Token aus und fügen ihn nicht in den Client ein. Die bestehende API-Token-Remote-Kompatibilitätsmethode verwendet:

Authorization: Bearer your_token

oder für lokales stdio:

JUSTONEAPI_TOKEN=your_token

Lokales stdio verwendet die obige Umgebungsvariable. Committen Sie niemals einen echten Token in ein Repository.

OAuth-Zugriffstokens verwenden drei Scopes mit minimalen Rechten:

• mcp:catalog:read — Endpunkte durchsuchen, Schemas prüfen und Plattformen auflisten.

• mcp:api:call — einen JustOneAPI-Endpunkt aufrufen.

• mcp:account:read — Guthaben und Nutzung anzeigen.

call_endpoint kann mit dem während OAuth verknüpften API-Token und dessen aktueller Preisgestaltung, Berechtigungen, Guthaben und Budget Kosten verursachen. Es validiert den Endpunkt und die Parameter, bevor es ein kurzlebiges Delegationstoken erhält, und führt dann genau einen Upstream-Aufruf aus. Es wiederholt ein unklares Timeout, einen Netzwerkfehler oder ein HTTP-502/503/504-Ergebnis nicht automatisch.

Legacy-API-Tokens werden weiterhin im etablierten Query/Form-Format an das JustOneAPI-Backend gesendet. OAuth-Zugriffs- und Delegationstokens werden niemals in Backend-URLs oder Formular-Bodies platziert; Delegationstokens werden nur als Authorization-Bearer-Header gesendet.

Operator-Rollout

Die Produktion läuft derzeit im dual-Modus. OAuth ist additiv und per Feature-Flag gesteuert, und diese Schalter bleiben die Grenze für Bereitstellung und Rollback:

• JUSTONEAPI_OAUTH_MODE=off hält den Remote-Dienst nur im Legacy-Modus und blendet OAuth-Discovery-Metadaten aus.

• JUSTONEAPI_OAUTH_MODE=dual akzeptiert sowohl vorhandene API-Tokens als auch Standard-OAuth auf der exakten Origin https://mcp.justoneapi.com.

• Preview- und workers.dev-Routen bleiben weiterhin nur im Legacy-Modus, selbst wenn die Variable auf dual gesetzt ist.

Der Worker verwendet private_key_jwt für die Introspection des Autorisierungsservers und den RFC-8693-Token-Austausch. Speichern Sie das private JWK-Set und das aktive kid als Worker-Geheimnisse; committen Sie niemals .dev.vars, PEM-Dateien oder private JWK-Sets. Rotieren Sie Schlüssel, indem Sie zuerst alte und neue öffentliche Schlüssel veröffentlichen, dann das aktive kid umstellen und den ausgemusterten Schlüssel erst nach der Überlappungsperiode entfernen.

npm 2.0 wird zunächst über OIDC-Trusted-Publishing unter dem next-dist-tag veröffentlicht. Nachdem das exakt veröffentlichte Artefakt die Node.js-20-, 22- und 24-Smoke-Tests bestanden hat, promotet ein Operator es separat mit npm 2FA, indem er npm dist-tag add justoneapi-mcp@2.0.0 latest verwendet. Dies wird niemals mit einem NPM_TOKEN automatisiert. Siehe RELEASE.md.

Mögliche Fragen

Stellen Sie Ihrem MCP-Client natürlich formulierte Fragen:

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

Weitere Beispiele:

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?

Der Assistent kann verfügbare JustOneAPI-Endpunkte durchsuchen, erforderliche Parameter erklären, die ausgewählte API aufrufen, nachdem Sie die benötigten Werte angegeben haben, und bei der Interpretation häufiger Antwortcodes helfen.

Lizenz

MIT