Finnhub über MCP mit Gemini verbinden

💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Einloggen, Connectors → Finnhub klicken, Zugangsdaten einfügen, MCP-API-Key erzeugen, fertig. Kein Docker, kein git clone, kein lokaler Server.

Finnhub + Gemini

Gib deiner KI Live-Marktdaten von Finnhub: Kurse für Aktien, Devisen und Kryptowährungen, Unternehmensprofile und Kennzahlen, Unternehmens- und Marktnachrichten, Analystenempfehlungen, Kalender für Quartalszahlen und Börsengänge, Insider-Transaktionen, SEC-Einreichungen und Börsenstatus. Funktioniert mit dem kostenlosen Finnhub-Tarif; nur lesend.

Voraussetzungen

Die vollständige Setup-Anleitung ist in den Connector eingebaut (im Store sichtbar, wenn du den Connector auswählst). Benötigte Umgebungsvariablen für diesen Connector:

FINNHUB_API_KEY

Schritt 1 — Zugangsdaten holen

Die Einrichtung dauert etwa 1 Minute. Du brauchst einen Finnhub-API-Key; der kostenlose Tarif deckt jedes Tool ab außer der Kurshistorie als Candles.

1. Registriere dich auf finnhub.io/register. Das ist kostenlos.
2. Öffne das Dashboard auf finnhub.io/dashboard und kopiere den API-Key, der dort steht.
3. Füge nur den Key in FINNHUB_API_KEY ein, ohne token= und ohne Leerzeichen. Der Connector schickt ihn im Header X-Finnhub-Token, nie in der URL.
4. Installiere den Connector und führe finnhub_get_market_status mit der Börse US aus: Es zeigt dir, ob der US-Markt gerade offen ist und in welcher Handelsphase er ist.

Was er liest: Kurse für Aktien, ETFs, Devisen und Krypto; Unternehmensprofile mit Marktkapitalisierung und ausstehenden Aktien; Kennzahlen wie 52-Wochen-Hoch und -Tief, Beta, KGV, KBV, Gewinn je Aktie, Margen, Eigenkapitalrendite und Dividendenrendite; Unternehmens- und Marktnachrichten (allgemein, Devisen, Krypto, Fusionen); vergleichbare Unternehmen; monatliche Analystenempfehlungen; Gewinnüberraschungen und den Kalender der Quartalszahlen; den IPO-Kalender; Insider-Transaktionen und Insider-Stimmung; Finanzberichte, wie sie bei der SEC eingereicht wurden, und die Liste der SEC-Einreichungen; Börsenstatus und Feiertage; und die Symbollisten der Devisenanbieter und Kryptobörsen.

Zuerst das Symbol: Die KI ermittelt den Ticker mit finnhub_search_symbols, über Firmenname, Symbol, ISIN oder CUSIP. US-Ticker stehen ohne Zusatz, etwa AAPL; andere Börsen haben ein Suffix, etwa SAP.DE oder VOD.L. Devisen- und Kryptokurse brauchen das Symbol der Börse, etwa OANDA:EUR_USD oder BINANCE:BTCUSDT, das die KI mit finnhub_list_forex_symbols oder finnhub_list_crypto_symbols nachschlägt.

Die Zahlen lesen: Die Felder eines Kurses sind kurz: c aktuell, d Veränderung, dp Veränderung in Prozent, h Hoch, l Tief, o Eröffnung, pc Schlusskurs des Vortags, t Zeit in Unix-Sekunden. Marktkapitalisierung und ausstehende Aktien sind in Millionen angegeben. Datumsangaben sind JJJJ-MM-TT. Die eingereichten Finanzberichte sind große Antworten, deshalb grenzt die KI finnhub_get_financials_reported mit einem Von- und Bis-Datum ein.

Kostenloser Tarif: Jedes Tool funktioniert außer finnhub_get_stock_candles (Kurshistorie), das einen bezahlten Tarif braucht und bei kostenlosen Keys mit 403 antwortet; dann nimmt die KI stattdessen finnhub_get_quote und die 52-Wochen-Werte aus finnhub_get_basic_financials. Manche Daten reichen mit kostenlosen Keys weniger weit zurück: Unternehmensnachrichten ein Jahr, Gewinnüberraschungen die letzten 4 Quartale, der Kalender der Quartalszahlen einen Monat plus kommende Termine. Echtzeitkurse gibt es für US-Aktien; andere Märkte brauchen einen bezahlten Tarif.

Nur lesend: Jedes Tool liest nur. Der Connector platziert keine Orders und bewegt kein Geld, deshalb gibt es nichts zu bestätigen, und kein Tool ist bei der Installation ausgeschaltet.

Limits: Der kostenlose Tarif erlaubt 60 Aufrufe pro Minute und 30 pro Sekunde. Nach einem 429 wartet die KI eine Minute, und sie nimmt lieber einen gezielten Aufruf als viele breite.

Häufige Fehler: 401 heißt, Finnhub hat den Key abgelehnt: Kopiere ihn erneut aus dem Dashboard. 403 "You don't have access to this resource" heißt, der Key funktioniert, aber diese Daten sind nicht in deinem Tarif. 429 heißt, das Limit pro Minute ist erreicht.

Keine Anlageberatung: Marktdaten sind Informationen. Fragst du, was du kaufen oder verkaufen sollst, zeigt dir die KI die Zahlen und sagt dir, dass das keine Anlageberatung ist.

Der Connector handelt nicht, platziert keine Orders, verbindet sich mit keinem Depot und liest kein Portfolio.

Schritt 2 — Adapter installieren

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Schritt 3 — Connector in Gemini hinzufügen

Deine Server-URL: Öffne in AnythingMCP MCP Servers → den Server, auf dem dieser Connector liegt, und kopiere seine URL (https://cloud.anythingmcp.com/mcp/…). Setze sie überall ein, wo diese Anleitung YOUR_SERVER_ID zeigt.

Gemini CLI liest MCP-Server aus ~/.gemini/settings.json (unter Windows %USERPROFILE%\.gemini\settings.json). Füge hinzu:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Erstelle in AnythingMCP unter MCP Servers → dein Server → API keys einen MCP-API-Key und setze ihn anstelle von YOUR_MCP_API_KEY ein.
2. Speichere die Datei und starte gemini neu.
3. Führe in der Gemini CLI /mcp aus (oder gemini mcp list im Terminal): anythingmcp sollte als verbunden erscheinen.
4. Leg los: Gemini CLI kann jetzt die Finnhub-Tools aufrufen.

Verfügbare Tools

Beispiel-Prompts

• „Wo steht die SAP-Aktie gerade, und wie viel hat sie heute gewonnen oder verloren?“
• „Vergleich KGV, Margen und Dividendenrendite von Siemens, Allianz und BASF.“
• „Welche Unternehmen legen nächste Woche Quartalszahlen vor, und welchen Gewinn je Aktie erwarten die Analysten?“
• „Haben Insider bei Nvidia in den letzten drei Monaten Aktien gekauft oder verkauft?“
• „Was gibt es Neues zu Tesla, und was haben die Analysten in den letzten Monaten empfohlen?“

FAQ

Wo sucht Gemini CLI nach MCP-Servern? In ~/.gemini/settings.json für deinen Benutzer oder in .gemini/settings.json innerhalb eines Projekts. gemini mcp list zeigt jeden Server und ob er sich verbindet.

Nächste Schritte

• Connector-Startseite
• Mit Claude verbinden
• Mit ChatGPT verbinden