Claude und ChatGPT per MCP mit Live-Goldpreisen verbinden
Claude, ChatGPT, Cursor und VS Code mit dem MCP-Server von MetalAPI an Live-Gold- und Metallpreise anbinden: OAuth oder API-Schlüssel, Tools, Sicherheit, Kontingent.
Warum ein Assistent ein Preis-Tool braucht
Fragen Sie einen Chat-Assistenten ohne Tools nach dem heutigen Goldpreis, erhalten Sie eine von drei Antworten: eine Absage, eine Zahl aus seinen Trainingsdaten oder eine Schätzung, die selbstbewusster vorgetragen wird, als sie es verdient. Keine davon ist nützlich. Ein Sprachmodell lernt aus einem Textbestand, der Monate vor Ihrem Gespräch endet, während sich Gold-, Silber- und Ölpreise bei geöffneten Märkten alle paar Sekunden bewegen.
Der übliche Behelf: Sie schlagen den Preis selbst nach und fügen ihn in den Chat ein. Das funktioniert für eine Frage und stößt dann an seine Grenzen. Sie müssen sich merken, welche Einheit Sie kopiert haben (Feinunze oder Gramm?), welche Währung und wann die Zahl erhoben wurde. Fragen Sie anschließend nach der Spanne des letzten Monats oder nach einer Umrechnung in türkische Lira, sind Sie wieder im Browser.
Das Model Context Protocol (MCP) erspart Ihnen diesen Schritt. Der Assistent erhält eine kleine Auswahl an Tools, die er selbst aufrufen kann, und jede Antwort beruht auf einer frischen API-Antwort mit eigenem Zeitstempel, eigener Basiswährung und Einheit. Dieser Artikel zeigt, wie Sie Claude, ChatGPT, Claude Code, Cursor und VS Code mit dem MCP-Server von MetalAPI verbinden, was der Assistent danach kann und welche Schutzmechanismen gelten.
| Aspekt | Zahlen von Hand einfügen | Ein MCP-Tool aufrufen |
|---|---|---|
| Aktualität | Was Sie kopiert haben, wann immer Sie es kopiert haben | Der neueste Preis, den Ihr Tarif erlaubt, abgerufen in dem Moment, in dem Sie fragen |
| Einheiten und Währung | Feinunzen, Gramm und Währungen geraten leicht durcheinander | Explizite Argumente base und unit, in der Antwort wiederholt |
| Zeitstempel | Geht meist unterwegs verloren | Jede Antwort enthält timestamp und date |
| Rückfragen | Erneut von Hand nachschlagen | Der Assistent ruft ein weiteres Tool auf |
| Historie und Umrechnungen | Eine separate Website oder Tabellenkalkulation | Tools für Zeitreihen, OHLC, Veränderung und Umrechnung |
Was MCP ist
MCP ist ein offenes Protokoll, das Anthropic 2024 vorgestellt hat und das inzwischen von vielen KI-Anwendungen unterstützt wird. Es standardisiert, wie ein Assistent mit externen Tools und Daten kommuniziert. Ein MCP-Server veröffentlicht eine Liste von Tools. Jedes Tool hat einen Namen, eine Beschreibung in natürlicher Sprache, ein JSON-Schema für seine Argumente und optionale Annotationen wie „nur lesend“. Ein MCP-Client (Claude, ChatGPT, Cursor, VS Code und andere) liest diese Liste, lässt das Modell entscheiden, wann ein Tool relevant ist, sendet den Aufruf an den Server und gibt das Ergebnis an das Modell zurück.
Das Modell selbst sieht Ihre Zugangsdaten nie und spricht nie direkt mit der API. Es erzeugt eine strukturierte Anfrage wie „rufe get_latest_prices mit symbols: XAU und base: EUR auf“, der Client führt sie aus, und das Modell formuliert seine Antwort auf Basis des zurückgelieferten JSON.
Der Server von MetalAPI ist unter https://metalapi.com/mcp erreichbar. Er spricht Streamable HTTP, den in der MCP-Spezifikation definierten Remote-Transport, und ist zustandslos: Jeder Aufruf ist eine unabhängige HTTPS-Anfrage mit einer JSON-Antwort, es muss also keine langlebige Sitzung aufrechterhalten werden. Der Server ist in der offiziellen MCP Registry als com.metalapi/metalapi gelistet. Wenn Sie die URL im Browser öffnen, werden Sie auf die Übersichtsseite KI & MCP weitergeleitet.
Anmeldung per OAuth oder API-Schlüssel
Jeder Aufruf an den Server wird authentifiziert. Dafür gibt es zwei Wege, und welcher passt, hängt vom Client ab:
- OAuth 2.1 (Anmeldung) für Apps mit einer Konnektor-Oberfläche, etwa Claude und ChatGPT. Der Client findet den Autorisierungsserver selbst: Ein nicht authentifizierter Aufruf erhält eine
401-Antwort mit einemWWW-Authenticate-Header, der auf die Protected-Resource-Metadaten des Servers verweist. Anschließend registriert sich der Client per Dynamic Client Registration und öffnet eine Anmeldeseite von MetalAPI. Der Ablauf nutzt PKCE, daher muss kein Client-Secret in die App eingebaut werden. Sie melden sich an oder erstellen ein kostenloses Konto und genehmigen die Verbindung. - API-Schlüssel für Entwicklerwerkzeuge, in denen Sie HTTP-Header setzen können, etwa Claude Code, Cursor und VS Code. Sie senden denselben Schlüssel, den Sie für die REST-API verwenden, als
Authorization: Bearer mk_live_….
Beide Wege führen zum selben Konto, Tarif und Kontingent. Einen Unterschied gibt es bei der Tool-Liste: create_api_key wird nur bei OAuth-Verbindungen angeboten. Ein Schlüssel, der in eine Konfigurationsdatei kopiert wurde, soll niemals weitere Schlüssel erzeugen können. Eine Verbindung per Schlüssel sieht daher zwölf statt dreizehn Tools.
OAuth-Verbindungen werden in Ihrem Dashboard unter Settings → Connected apps aufgeführt, wo Sie jede davon trennen können. API-Schlüssel können Sie unter API keys erneuern oder widerrufen. Behandeln Sie einen Schlüssel in einer MCP-Konfigurationsdatei genau wie einen Schlüssel in Ihrem Quellcode.
Claude und ChatGPT verbinden
Für Claude auf claude.ai und in Claude Desktop:
- Öffnen Sie Settings → Connectors und wählen Sie Add custom connector.
- Geben Sie als Namen MetalAPI und als URL
https://metalapi.com/mcpein. - Klicken Sie auf Connect, melden Sie sich bei MetalAPI an (oder erstellen Sie ein kostenloses Konto) und klicken Sie auf Allow.
Öffnen Sie in ChatGPT Settings → Apps & Connectors und erstellen Sie im Entwicklermodus einen Konnektor mit der URL https://metalapi.com/mcp und OAuth-Authentifizierung. ChatGPT öffnet die Anmeldeseite von MetalAPI; bestätigen Sie die Verbindung, und die Tools stehen in Ihren Chats zur Verfügung. Ob Sie eigene Konnektoren hinzufügen können, hängt von Ihrem ChatGPT-Tarif ab und in einem Workspace davon, was der Administrator erlaubt.
Die Menünamen in beiden Apps ändern sich von Zeit zu Zeit. Die MCP-Einrichtungsanleitung wird mit den aktuellen Schritten für jeden Client auf dem neuesten Stand gehalten.
In Ihrer ersten Unterhaltung hilft es, die Quelle zu nennen („Mit MetalAPI: Wie hoch ist …“), damit der Assistent zum Tool greift statt zu seinem Gedächtnis. Danach wählen die meisten Assistenten das Tool von selbst, sobald es in einer Frage um einen Preis geht.
Claude Code, Cursor und VS Code verbinden
Coding-Assistenten verwenden in der Regel einen API-Schlüssel. Erstellen Sie einen im Dashboard (der Free-Tarif genügt für den Anfang) und nutzen Sie für jedes Tool einen eigenen Schlüssel, damit Sie einen widerrufen können, ohne die anderen lahmzulegen.
Fügen Sie den Server in Claude Code über das Terminal hinzu:
claude mcp add --transport http metalapi https://metalapi.com/mcp \
--header "Authorization: Bearer YOUR_API_KEY"Wenn Sie keinen Schlüssel speichern möchten, fügen Sie den Server ohne --header hinzu und führen Sie in Claude Code /mcp aus, um sich stattdessen per OAuth anzumelden.
Fügen Sie den Server in Cursor zu ~/.cursor/mcp.json hinzu oder zu .cursor/mcp.json innerhalb eines Projekts:
{
"mcpServers": {
"metalapi": {
"url": "https://metalapi.com/mcp",
"headers": { "Authorization": "Bearer YOUR_API_KEY" }
}
}
}Speichern Sie in VS Code mit GitHub Copilot Folgendes als .vscode/mcp.json. Durch den inputs-Block fragt VS Code einmal nach dem Schlüssel und speichert ihn sicher, sodass der Schlüssel nie in der Datei selbst steht:
{
"inputs": [
{ "type": "promptString", "id": "metalapi-key", "description": "MetalAPI API key", "password": true }
],
"servers": {
"metalapi": {
"type": "http",
"url": "https://metalapi.com/mcp",
"headers": { "Authorization": "Bearer ${input:metalapi-key}" }
}
}
}Andere Clients, die Remote-MCP-Server über Streamable HTTP unterstützen, etwa Windsurf, folgen demselben Muster: die Server-URL plus entweder ein Bearer-Header oder eine OAuth-Anmeldung.
So sieht eine Unterhaltung aus
Nach der Verbindung fragen Sie in natürlicher Sprache, und der Assistent wählt ein Tool und dessen Argumente. Einige typische Fragen und die Aufrufe, zu denen sie führen:
| Sie fragen | Tool | Argumente |
|---|---|---|
| Wie hoch ist der Goldpreis pro Gramm in Euro gerade? | get_latest_prices | symbols: XAU, base: EUR, unit: gram |
| Wie hat sich Silber in den letzten zwei Wochen entwickelt? | get_timeseries oder get_fluctuation | symbols: XAG, start_date, end_date |
| Rechne 2,5 Feinunzen Platin in türkische Lira um. | convert | from: XPT, to: TRY, amount: 2.5 |
| Wie lagen Eröffnungs-, Höchst-, Tiefst- und Schlusskurs von Gold heute? | get_ohlc | symbols: XAU |
| Was kostet 18-karätiges Gold pro Gramm in Pfund? | get_carat_prices | base: GBP (kostenpflichtige Tarife) |
| Welchen Tarif habe ich, und wie viel Kontingent ist noch übrig? | get_account | Keine |
Preis-Tools liefern kompaktes JSON. Der rates-Block der REST-API führt aus Kompatibilitätsgründen mit älteren Integrationen jedes Symbol zweimal auf, als Preis und als Kehrwert. Der MCP-Server behält nur die Preise, nach Symbol geordnet, unter prices. Das halbiert die Zahl der Tokens ungefähr und beseitigt die häufigste Ursache für Fehlinterpretationen der Daten. Ein Aufruf von get_latest_prices mit symbols: XAU,XAG, base: EUR und unit: gram liefert etwa Folgendes:
{
"success": true,
"timestamp": 1792834892,
"date": "2026-10-24",
"base": "EUR",
"unit": "gram",
"rate_limit": {
"limit": 10000,
"remaining": 9874,
"reset": 1793491200,
"used": 126,
"plan": "Standard",
"reset_date": "2026-11-01T00:00:00.000Z"
},
"prices": {
"XAU": 110.4064149,
"XAG": 1.489616277
}
}Die Zahlen in diesem Artikel sind beispielhaft. Echte Antworten verwenden die neuesten Preise, die Ihr Tarif erlaubt.
Da jede Antwort timestamp, base und unit enthält, sagt eine gute Antwort, dass Gold zu einem bestimmten Zeitpunkt bei etwa 110 € pro Gramm lag, und nicht nur „110 €“. Fehlt dieser Kontext in einer Antwort, fragen Sie danach.
Assistenten können Aufrufe auch verketten. Bitten Sie darum, das Gold-Silber-Verhältnis von heute mit dem vor einem Monat zu vergleichen, kann ein Assistent beide Metalle für beide Daten abrufen und die Division selbst vornehmen. Bitten Sie um ein Diagramm, kann ein Client, der Code ausführen kann, aus einem get_timeseries-Ergebnis eines erstellen.
Die 13 Tools
Der Server stellt dreizehn Tools bereit. Sieben liefern Marktdaten und werden – genau wie ein REST-Aufruf – jeweils als eine Anfrage auf das Monatskontingent Ihres Tarifs angerechnet. Die übrigen sind kostenlos.
| Tool | Funktion | Kontingent |
|---|---|---|
get_latest_prices | Aktuelle Preise für Metalle, Energie, Währungen und Krypto, in jeder Basiswährung und Masseneinheit | 1 Anfrage |
get_historical_prices | Schlusskurse eines vergangenen Tages | 1 Anfrage |
convert | Rechnet einen Betrag zwischen zwei Symbolen um, zum aktuellen Preis oder zu einem vergangenen Tag | 1 Anfrage |
get_timeseries | Tägliche Schlusskurse zwischen zwei Daten (bis zu 30 Tage pro Aufruf im Free-Tarif, 365 in kostenpflichtigen Tarifen) | 1 Anfrage |
get_fluctuation | Anfangs- und Endpreis sowie absolute und prozentuale Veränderung zwischen zwei Daten | 1 Anfrage |
get_ohlc | Eröffnungs-, Höchst-, Tiefst- und Schlusskurs eines Tages | 1 Anfrage |
get_carat_prices | Goldpreise nach Karat, etwa 22 oder 18 Karat (kostenpflichtige Tarife) | 1 Anfrage |
list_symbols | Alle Symbolcodes mit Name, Kategorie und Einheit | Kostenlos |
get_account | Ihr Tarif, Ihr Monatskontingent, Ihre Nutzung und das Rücksetzdatum | Kostenlos |
list_plans | Alle Tarife mit Limits sowie Monats- und Jahrespreisen | Kostenlos |
list_api_keys | Ihre aktiven API-Schlüssel, maskiert | Kostenlos |
create_api_key | Erstellt einen Schlüssel für Ihre eigenen Apps; nur bei OAuth-Verbindungen; fragt vorher nach | Kostenlos |
get_upgrade_link | Bereitet einen Stripe-Checkout-Link vor, für Abonnenten einen Link zum Abrechnungsportal; fragt vorher nach | Kostenlos |
Beim Verbindungsaufbau sendet der Server außerdem kurze Anweisungen: was die Symbolcodes bedeuten, dass Metallpreise pro Feinunze gelten, sofern keine Einheit angegeben ist, und dass Daten-Tools Kontingent verbrauchen. Clients geben diese an das Modell weiter. Deshalb fragt ein gut funktionierender Assistent nur die Symbole ab, die er benötigt. Weniger Symbole bedeuten kürzere Antworten und weniger Tokens.
Sicherheit: standardmäßig nur lesend, keine Zahlungen
Einem Assistenten Zugriff auf ein Konto zu geben, wirft eine berechtigte Frage auf: Was kann er verändern? Das Design hält die Antwort kurz.
- Elf der dreizehn Tools sind nur lesend. Sie tragen die MCP-Annotation
readOnlyHintund können nur Preise, Ihren Tarif, Ihre Nutzung und maskierte Schlüsseldaten lesen. - Die beiden schreibenden Tools fragen vorher nach.
create_api_keyundget_upgrade_linksind als Aktionen gekennzeichnet, die etwas verändern. MCP-Clients bitten Sie daher um Bestätigung, bevor sie sie ausführen. - Der Server berechnet niemals etwas.
get_upgrade_linkerstellt eine Stripe-Checkout-Sitzung für den gewünschten Tarif oder, wenn Sie bereits Abonnent sind, einen Link zum Abrechnungsportal und gibt die URL zurück. Sie öffnen sie, prüfen den Preis und bezahlen selbst. Der Assistent kann keine Zahlung abschließen. - Neue Schlüssel werden einmal angezeigt. Ein über
create_api_keyerstellter Schlüssel wird wie im Dashboard ein einziges Mal vollständig zurückgegeben, und gespeichert wird nur ein Hash davon. - Enger Zugriffsbereich. Die Verbindung reicht bis zu MetalAPI und nicht weiter: Preise, Ihr Tarif, Ihre Nutzung und API-Schlüssel. Der Server sieht Ihre Unterhaltungen, Dateien oder andere Konnektoren nie.
- Protokolliert wie API-Traffic. Marktdatenaufrufe erscheinen im Anfrageprotokoll Ihres Dashboards als
/mcp/, gefolgt vom Tool-Namen, neben Ihren REST-Anfragen.
Eine allgemeine MCP-Gewohnheit lohnt sich bei jedem Server: Lesen Sie die Bestätigungsdialoge Ihres Clients, statt sie reflexartig zu genehmigen, und entfernen Sie Konnektoren, die Sie nicht mehr nutzen.
Kontingente, Aktualität und Tarife
MCP-Aufrufe greifen auf dasselbe Kontingent zu wie die REST-API. Ein Aufruf eines Daten-Tools kostet eine Anfrage, egal wie viele Symbole er liefert, während list_symbols und die Konto-Tools nichts kosten. Zusätzlich gelten Limits pro Minute, beginnend bei 10 Anfragen pro Minute im Free-Tarif.
Die Preise sind so aktuell, wie Ihr Tarif es erlaubt. Im Free-Tarif sieht der Assistent tägliche Preise; kostenpflichtige Tarife aktualisieren von alle 30 Minuten bis hin zu alle 5 Sekunden:
| Tarif | Preis / Monat | Anfragen / Monat | Aktualisierungsintervall |
|---|---|---|---|
| Free | 0 $ | 100 | Täglich |
| Lite | 4,99 $ | 1.000 | 30 Minuten |
| Standard | 11,99 $ | 10.000 | 10 Minuten |
| Advanced | 24,99 $ | 50.000 | 1 Minute |
| Pro | 49,99 $ | 100.000 | 1 Minute |
| Ultra | 99,99 $ | 500.000 | 15 Sekunden |
| Business | 149,99 $ | 500.000 | 15 Sekunden |
| Enterprise | 299,99 $ | 1.500.000 | 5 Sekunden |
Hundert Anfragen im Monat reichen für gelegentliche Fragen im Chat. Wenn Sie einen Assistenten für Analysen nutzen, die viele Zeitreihen abrufen, oder ihn in einen Agenten einbinden, der nach Zeitplan läuft, lassen Sie ihn ab und zu get_account aufrufen: Das Tool meldet verbrauchte und verbleibende Anfragen und wann das Kontingent zurückgesetzt wird. Ist das Monatskontingent aufgebraucht, liefern Daten-Tools bis zum 1. des Monats (UTC) einen Fehler wegen überschrittenen Kontingents mit einem Upgrade-Link, während die Konto-Tools weiter funktionieren. Die Preisseite bietet den vollständigen Vergleich.
Der Einstieg dauert nur ein paar Minuten: Registrieren Sie sich für ein kostenloses Konto, folgen Sie der MCP-Einrichtungsanleitung für Ihren Client und stellen Sie Ihre erste Frage. Die Seite KI & MCP fasst die Einrichtung zusammen, und die API-Dokumentation beschreibt die REST-Endpunkte hinter jedem Tool.
Probieren Sie es mit Ihren eigenen Daten aus
Erstellen Sie ein kostenloses Konto und senden Sie Ihre erste Anfrage in unter zwei Minuten. 100 Anfragen pro Monat, keine Kreditkarte.
Weiterlesen
Spot, Geld, Brief und Spread: So werden Edelmetallpreise notiert
Spot, Geld- und Briefkurs, Mittelkurs und Spread bei Edelmetallen erklärt: wie Händler Preise stellen und wie Sie Geld-/Briefkurse per API abrufen und anzeigen.
Kupfer-, Aluminium-, Zink- und Ölpreise per API: Ein Leitfaden für Entwickler
Kupfer-, Aluminium-, Zink-, Stahl-, Rohöl- und Erdgaspreise per API: marktübliche Einheiten, Normalisierung, Frontmonats-Futures, Umrechnung und Codebeispiele.
Die richtige Edelmetallpreis-API wählen: 12 Fragen, die Sie stellen sollten
Anbieterneutrale Checkliste für die Wahl einer Edelmetallpreis-API: Quellen, Aktualität, Historie, Einheiten, Geld/Brief, Limits, Preise, Sicherheit, Lizenz und MCP.