Verbinde deinen Agenten

Verbinde den Public-Data-MCP-Server mit deinem Agenten — read-only, OAuth, kein API key. Die Open-Source-Agenten und -Skills liegen unter github.com/unifapi-agent/agents.

Für die meisten Clients musst du keine Konfigurationsdatei anfassen oder einen Token einfügen. Füge den Server hinzu (ein eingefügter Prompt oder ein Web-Connector), führe dann einen Agenten oder Skill aus und melde dich mit OAuth an, wenn der Agent zum ersten Mal Live-Data benötigt.

Verbinde deinen Agenten

Wähle den Pfad für deinen Client. Jeder verdrahtet den gehosteten MCP-Server (https://mcp.unifapi.com) für Live-Data; füge die Agent Skills mit npx skills add unifapi-agent/agents hinzu.

Füge einen Prompt ein

Claude Code, Codex, Cursor, OpenClaw, Goose, Hermes — jeder Agent, der seine eigenen MCP-Server verwaltet. Füge dies ein, und es fügt den Server hinzu und führt die OAuth-Anmeldung aus:

Install the UnifAPI MCP server for me, then confirm it connected. It's a remote
(streamable HTTP) MCP server at https://mcp.unifapi.com. UnifAPI uses OAuth — open
the browser sign-in when prompted. It's read-only public data, no API key to paste.

Web-Connector (Claude, ChatGPT, Perplexity, Grok)

Füge einen Custom Connector hinzu, der auf https://mcp.unifapi.com zeigt, und autorisiere über OAuth. ChatGPT benötigt den Developer Mode (Plus, Pro, Team, Enterprise):

Settings -> Connectors -> Advanced -> enable Developer Mode
Connectors -> Create
MCP server URL: https://mcp.unifapi.com
Authentication: OAuth

Codex

Codex verdrahtet MCP und Skills separat. Füge den MCP-Server in ~/.codex/config.toml hinzu:

[mcp_servers.unifapi]
url = "https://mcp.unifapi.com"

Melde dich dann an und füge die Skills hinzu:

codex mcp login unifapi
npx skills add unifapi-agent/agents

Claude-kompatible Plugin-Hosts

Claude Code, Claude Desktop und OpenClaw können die Skills und den MCP-Server in einem Schritt zusammen installieren:

/plugin marketplace add unifapi-agent/agents
/plugin install unifapi@unifapi

Führe danach einen Agenten oder Skill aus und schließe die OAuth-Anmeldung ab, wenn du dazu aufgefordert wirst.

Jeder andere MCP-Client

Füge die Skills hinzu und richte den Client dann auf den gehosteten MCP-Server für Live-Data aus:

npx skills add unifapi-agent/agents

MCP server URL: https://mcp.unifapi.com

Führe es aus

Starte nach der Installation einen neuen Chat oder Thread und frage nach einem Aufgabenergebnis. Die Agent Skills entdecken und rufen Public-Data-Operationen über MCP nach Bedarf auf:

Analyze these Twitter/X KOLs for an AI developer-tool campaign: @vercel, @shadcn, @rauchg.
Use UnifAPI public data and return price ranges, evidence, confidence, and follow-up questions.

OAuth öffnet sich nur, wenn der Agent zum ersten Mal UnifAPI-Tools aufrufen oder Workspace-Credits ausgeben muss, sodass du durchsuchen und eine Aufgabe starten kannst, bevor du dich anmeldest. Siehe Skills für das Workflow-Modell.

Was dein Agent tun kann

Das Verbinden gibt einem Agenten Zugriff auf die Live-Public-Data-Operationen hinter UnifAPI. Es ist nützlich für Arbeit wie:

• Twitter/X-KOL-Analyse und Influencer-Shortlists
• Creator-Discovery über TikTok, YouTube, Instagram, Reddit und andere unterstützte Plattformen
• Wettbewerbsbeobachtung aus öffentlichen Posts, Profilen, Kommentaren und Trends
• Marktforschung aus öffentlichen Social-Signalen
• Lead- und Unternehmensanreicherung aus öffentlichen LinkedIn-artigen Daten

Der Agent sollte üblicherweise ein Briefing, eine Tabelle, eine Shortlist, eine Preisspanne oder einen Folgeplan zurückgeben — keine rohen API-Dumps.

Über MCP bereitgestellte Tools

UnifAPI stellt drei MCP-Tools bereit. Es registriert nicht ein separates MCP-Tool für jeden API-Endpunkt.

Typischer Agent-Ablauf:

Erweitert: MCP-Server-URL & API-key-Bearer

Die obigen Pfade decken die meisten Clients ab. Nutze diesen Abschnitt, wenn du MCP von Hand verdrahtest, auf dem HTTP-MCP-Transport aufbaust oder die Verbindung für einen Client produktisierst, der explizite Konfiguration benötigt.

UnifAPI stellt seine Public-Data-Schicht über einen gehosteten MCP-Server bereit:

https://mcp.unifapi.com

Manuelle MCP-Einrichtung

Wenn dein Client eine rohe Connector-URL statt des Plugins akzeptiert, füge den gehosteten Server direkt hinzu.

Claude / Claude Desktop Custom Connector:

Customize -> Connectors -> + -> Add custom connector
Name: UnifAPI
URL: https://mcp.unifapi.com
Connect -> complete OAuth

Für Team- und Enterprise-Pläne fügt ein Owner den Connector zuerst über die Organization Settings -> Connectors hinzu; Mitglieder verbinden ihn dann über Customize -> Connectors. Für ältere, rein lokale Claude-Desktop- Setups kann mcp-remote den gehosteten Server über claude_desktop_config.json überbrücken:

{
  "mcpServers": {
    "unifapi": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.unifapi.com"]
    }
  }
}

Claude Code CLI:

claude mcp add \
  --transport http \
  unifapi \
  https://mcp.unifapi.com

Codex CLI:

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

OpenClaw Remote-Streamable-HTTP-Server:

openclaw mcp add unifapi \
  --url https://mcp.unifapi.com \
  --transport streamable-http \
  --auth oauth

openclaw mcp login unifapi
openclaw mcp doctor unifapi --probe

Hermes ~/.hermes/config.yaml:

mcp_servers:
  unifapi:
    url: "https://mcp.unifapi.com"
    auth: oauth

hermes mcp login unifapi

Cursor .cursor/mcp.json:

{
  "mcpServers": {
    "unifapi": {
      "url": "https://mcp.unifapi.com"
    }
  }
}

VS Code .vscode/mcp.json:

{
  "servers": {
    "unifapi": {
      "type": "http",
      "url": "https://mcp.unifapi.com"
    }
  }
}

Andere MCP-Clients — nutze Streamable HTTP mit der kanonischen Server-URL:

{
  "mcpServers": {
    "unifapi": {
      "url": "https://mcp.unifapi.com"
    }
  }
}

OAuth-Details

Der MCP-Server von UnifAPI ist eine OAuth Protected Resource.

Die Protected Resource Metadata teilen einem kompatiblen Client mit, wo er autorisieren muss und welcher Scope benötigt wird. Der OAuth-Token enthält einen Workspace-Claim, sodass Tool-Aufrufe dieselben Workspace-Credits ausgeben wie direkte HTTP-API-Aufrufe. OAuth autorisiert UnifAPI; es gewährt keinen Zugriff auf die privaten Quellkonten eines Nutzers.

Füge der Client-Konfiguration keine benutzerdefinierten Scope-Felder hinzu, es sei denn, dein MCP-Client unterstützt sie ausdrücklich. Ein kompatibler Client sollte die Protected Resource Metadata entdecken und den erforderlichen Scope anfordern.

API-key-Bearer-Fallback

Nutze dies nur, wenn ein Client OAuth nicht abschließen kann oder ausdrücklich nach einem Bearer-Token/-Header fragt. Die obigen OAuth-Pfade benötigen keinen API key.

1. Melde dich im UnifAPI-Dashboard an.
2. Erstelle einen API key.
3. Konfiguriere deinen MCP-Client so, dass er ihn als Authorization-Header sendet:

Authorization: Bearer YOUR_UNIFAPI_KEY

JSON-Beispiel im Cursor-Stil:

{
  "mcpServers": {
    "unifapi": {
      "url": "https://mcp.unifapi.com",
      "headers": {
        "Authorization": "Bearer YOUR_UNIFAPI_KEY"
      }
    }
  }
}

UnifAPI akzeptiert auch X-API-Key- und X-UnifAPI-Key-Header für Clients, die Authorization nicht setzen können, aber Authorization: Bearer ... wird bevorzugt.

Abrechnung und Credits

MCP-Aufrufe nutzen dasselbe Abrechnungsmodell wie HTTP-Aufrufe.

• Das Verbinden des MCP-Servers (und das Hinzufügen der Skills) ist kostenlos.
• call_api gibt Workspace-Credits aus, wenn es eine Public-Data-Operation aufruft.
• Abrechnungs-Metadaten werden im Tool-Ergebnis zurückgegeben, wenn die Operationsantwort sie enthält.
• Wenn ein Workspace keine Credits mehr hat, schlagen Aufrufe mit insufficient_credits fehl.

Siehe Rate Limits für Request-Limits und Fehler für das öffentliche Fehlervokabular.

Fehlerbehebung

Der Client fragt nach einem API key

Nutze den API-key-Bearer-Fallback oben. Das bedeutet üblicherweise, dass der Client die OAuth-Protected-Resource-Discovery noch nicht unterstützt.

OAuth gelingt, aber Tool-Aufrufe schlagen fehl

Prüfe, ob der OAuth-Flow die MCP-Resource und den Scope angefordert hat:

• Resource/Audience: https://mcp.unifapi.com/
• Scope: unifapi:mcp

Wenn ein Client während des Token-Austauschs die Resource/Audience nicht sendet, erhält er möglicherweise einen Token, der von der MCP Protected Resource nicht verifiziert werden kann.

401 unauthorized

Dem MCP-Request fehlt ein gültiger Token, der OAuth-Token ist für diese Resource ungültig, oder der API-key-Fallback-Token wurde widerrufen oder vertippt.

insufficient_credits

Der mit dem OAuth-Token oder API key verbundene Workspace hat nicht genug Credits. Lade Credits im Dashboard auf und wiederhole.

Tool-Liste erscheint veraltet

Starte oder lade den MCP-Client neu. Manche Clients cachen Server-Sessions und Tool-Listen.

Verwandte Ressourcen