Twelve Data

Twelve Data MCP Server

Verbinden Sie Claude, ChatGPT und andere KI-Assistenten mit der Twelve Data Finanz-API – Echtzeit- und historische Kurse, über 60 technische Indikatoren, Fundamentaldaten, Gewinne, Dividenden, ETFs, Unternehmensnachrichten, Marktbewegungen und mehr.

Sie benötigen ein Twelve Data Konto. Registrieren Sie sich unter twelvedata.com.

Es gibt zwei Möglichkeiten, den Server zu nutzen. Die meisten sollten den Cloud-Server verwenden (Option 1) – dort ist nichts zu installieren.

---

Option 1 – Cloud-Server nutzen (empfohlen)

Verbinden Sie Ihren KI-Assistenten mit unserem gehosteten Server:

https://mcp.twelvedata.com/mcp

Das war's. Keine Installation, kein API-Schlüssel zum Kopieren und Einfügen. Beim Verbinden öffnet sich ein Browserfenster und Sie melden sich mit Ihrem Twelve Data Konto an – Ihr persönlicher API-Schlüssel wird automatisch verknüpft und bleibt mit Ihrem Konto verbunden.

So fügen Sie ihn hinzu

Claude (Desktop / Web) und ChatGPT unterstützen benutzerdefinierte Connectors / MCP-Server:

1. Öffnen Sie die Einstellungen für Connectors (oder Integrationen / MCP-Server) Ihres Assistenten.
2. Fügen Sie einen neuen Connector mit der URL https://mcp.twelvedata.com/mcp hinzu.
3. Klicken Sie bei der Aufforderung auf Verbinden / Anmelden – eine Twelve Data Anmeldeseite öffnet sich in Ihrem Browser.
4. Autorisieren Sie und fertig. Fragen Sie zum Beispiel "Wie hoch ist der RSI für AAPL?" oder "Zeig mir die neuesten Gewinne von TSLA."

Die genauen Menünamen unterscheiden sich je nach App und Version, aber der Ablauf ist immer derselbe: URL hinzufügen, dann über das Browser-Popup anmelden.

Der MCP-Host stellt keine Tokens aus. Die Connector-URL ist https://mcp.twelvedata.com/mcp. Der Client muss den Metadaten der geschützten Ressource dieser URL zum dort genannten Autorisierungsserver folgen. Richten Sie einen Connector nicht auf die Host-Root (diese antwortet mit 404) oder auf /register oder /.well-known/oauth-authorization-server dieses Hosts.

Perplexity (benutzerdefinierter Remote-Connector)

Perplexity Pro-, Max- und Enterprise-Nutzer können den gehosteten Server als benutzerdefinierten Remote-Connector hinzufügen. Das ist eine Einrichtung pro Konto, keine Auflistung im öffentlichen kuratierten Verzeichnis von Perplexity.

1. Öffnen Sie in Perplexity Kontoeinstellungen → Connectors → + Benutzerdefinierter Connector und wählen Sie Remote. Bei Enterprise muss ein Administrator möglicherweise zuerst benutzerdefinierte Connectors erlauben.
2. Setzen Sie Name auf Twelve Data und MCP-Server-URL auf https://mcp.twelvedata.com/mcp.
3. Wählen Sie OAuth für die Authentifizierung und Streamable HTTP für den Transport. Lassen Sie Client-ID und Client-Secret leer, damit Perplexity die dynamische Client-Registrierung auf dem Autorisierungsserver nutzen kann, der in den Metadaten der geschützten Ressource des Servers genannt wird.
4. Akzeptieren Sie die Bestätigung für benutzerdefinierte Connectors von Perplexity und klicken Sie auf Hinzufügen. Klicken Sie dann auf die Twelve Data Connector-Karte, um die Authentifizierung zu starten, melden Sie sich bei Ihrem Twelve Data Konto an und autorisieren Sie den Zugriff.
5. Sobald der Connector aktiviert ist, probieren Sie diese Eingabeaufforderungen:
   • "Verwende Twelve Data, um das AAPL-Symbol zu finden."
   • "Verwende Twelve Data, um das neueste Angebot für AAPL inklusive Preis und Volumen zu erhalten."
   • "Verwende Twelve Data, um die letzten fünf täglichen Schlusskurse für AAPL anzuzeigen."
   • "Verwende Twelve Data, um den AAPL RSI anzuzeigen."

Jede Person meldet sich mit ihrem eigenen Twelve Data Konto an. Wenn ein Enterprise-Administrator den Connector teilt, verlangen Sie eine individuelle Authentifizierung für jedes Mitglied. Fügen Sie keinen Twelve Data API-Schlüssel in das Feld für die API-Schlüssel-Authentifizierung des Connectors ein.

Wenn das OAuth-Fenster blockiert ist, die Anmeldung fehlschlägt oder Tools nach einer Leerlaufzeit stoppen, öffnen Sie den Twelve Data Connector, deaktivieren Sie ihn, aktivieren Sie ihn erneut und melden Sie sich an. Verbinden Sie sich auf diese Weise neu, anstatt den Connector auf API-Schlüssel-Authentifizierung umzustellen. Bestätigen Sie, dass die URL exakt https://mcp.twelvedata.com/mcp ohne abschließenden Schrägstrich ist und dass der Twelve Data Plan die angeforderten Daten enthält. Siehe Perplexitys Leitfaden für benutzerdefinierte Remote-Connectors für die aktuellen Einstellungsbildschirme.

Codex (CLI, Desktop und IDE)

Fügen Sie den gehosteten MCP-Server zu Codex hinzu, ohne dieses Repository zu installieren oder einen API-Schlüssel zu kopieren:

codex mcp add twelvedata --url https://mcp.twelvedata.com/mcp
codex mcp list

Der Befehl add startet OAuth: Schließen Sie die Twelve Data Anmeldung in Ihrem Browser ab. Wenn Sie sich später erneut autorisieren müssen, führen Sie codex mcp login twelvedata aus. In Codex verwenden Sie /mcp, um die Verbindung zu prüfen, und fragen Sie dann: "Verwende Twelve Data, um das neueste Angebot für AAPL zu erhalten." und "Verwende Twelve Data, um den AAPL RSI anzuzeigen." Zum Trennen führen Sie codex mcp remove twelvedata aus.

Das öffentliche Plugin-Repository ist https://github.com/MazeBraker/twelvedata-skills. Es installiert die Fähigkeiten und denselben gehosteten MCP:

codex plugin marketplace add https://github.com/MazeBraker/twelvedata-skills
codex plugin add twelvedata@twelvedata-skills

---

Option 2 – Selbst mit einem API-Schlüssel ausführen

Möchten Sie den Server lieber auf Ihrem eigenen Rechner ausführen? Sie benötigen nur Ihren Twelve Data API-Schlüssel – keine OAuth-Einrichtung. Holen Sie ihn unter twelvedata.com → Ihrem Dashboard → API-Schlüssel.

1. Installation

Erfordert Python 3.10+ (3.12 empfohlen; auf macOS brew install python@3.12 oder make python-install).

make install

2. API-Schlüssel hinzufügen

Erstellen Sie eine .env-Datei im Projektstamm mit Ihrem Schlüssel, die nur für Sie lesbar ist:

echo 'TWELVE_DATA_API_KEY=your_api_key_here' > .env
chmod 600 .env

Der Server liest den Schlüssel aus .env und jede Anfrage verwendet ihn. Kein Anmeldeschritt erforderlich.

3. Über stdio verbinden

Claude Desktop – fügen Sie zu ~/Library/Application Support/Claude/claude_desktop_config.json hinzu:

{
  "mcpServers": {
    "twelvedata": {
      "command": "/path/to/mcp/.venv/bin/python",
      "args": ["/path/to/mcp/src/server.py"]
    }
  }
}

Verwenden Sie den .venv/bin/python-Pfad (nicht das System-Python – macOS liefert 3.9, und dieser Server benötigt 3.10+). Starten Sie Claude Desktop nach dem Bearbeiten der Konfiguration neu.

Claude Code:

claude mcp add twelvedata -- /path/to/mcp/.venv/bin/python /path/to/mcp/src/server.py

4. Über HTTP verbinden

make run           # serves http://localhost:8000/mcp

claude mcp add --transport http twelvedata http://localhost:8000/mcp

5. In Docker ausführen

docker build -t twelvedata-mcp .
docker run --rm --env-file .env -p 127.0.0.1:8000:8000 twelvedata-mcp

--env-file hält den Schlüssel aus Ihrem Shell-Verlauf heraus. Verbinden Sie sich wie in Schritt 4 mit http://localhost:8000/mcp. OAuth-Anmeldung wird in Docker nicht unterstützt.

6. Sicherheit

• make run und Docker bedienen /mcp ohne Authentifizierung, standardmäßig auf 0.0.0.0.
• Jeder Aufruf wird unter Ihrer Anmeldeinformation ausgeführt.
• Jeder, der den Port erreicht, kann auth_status und oauth_configure aufrufen. Das schließt eine von Ihnen geöffnete Webseite ein, durch DNS-Rebinding, da die Standardbindung weder den Host- noch den Origin-Header prüft.
• MCP_HOST=127.0.0.1 make run hält den Server lokal und aktiviert die Host- und Origin-Prüfung des MCP-SDKs.
• Mit MCP_HOST=127.0.0.1 funktioniert ngrok nur, wenn es mit --host-header=rewrite gestartet wird.

7. Fehlerbehebung

Rufen Sie zuerst auth_status von Ihrem Client aus auf. Es zeigt, ob ein API-Schlüssel konfiguriert ist, das gespeicherte Token, den erkannten Host und die Redirect-URI – normalerweise reicht das, um zu sehen, was fehlt.

---

Was Sie fragen können

• Kurse – Aktien, ETFs, Devisen, Kryptowährungen, Rohstoffe (Echtzeit & historisch)
• Technische Indikatoren – RSI, MACD, SMA, BBANDS, ATR und über 60 weitere
• Fundamentaldaten – Finanzberichte, Gewinne, Dividenden, Aktiensplits, Unternehmensprofile, Marktkapitalisierung, wichtige Kennzahlen, IPO-Kalender
• Fonds – ETF- & Investmentfondsprofile, Performance, Bestände, Risiko
• Nachrichten – Unternehmensnachrichten & Pressemitteilungen
• Marktinformationen – Marktbewegungen, Wechselkurse, Analystenbewertungen, Kursziele
• Regulatorisches – SEC/EDGAR-Einreichungen, Insider-Transaktionen, institutionelle Bestände

Symbolformate: Aktien AAPL, Kryptowährungen BTC/USD, Devisen EUR/USD.

---

Partner

Betreiben Sie Ihre eigene öffentliche Instanz oder richten Sie ein dediziertes OAuth-Login ein? Das ist eine Partnervereinbarung – kontaktieren Sie uns unter twelvedata.com und wir stellen Ihnen den Einrichtungsleitfaden und OAuth-Anmeldeinformationen bereit.