Der Capital.com MCP-Server ermöglicht es Ihrem KI-Assistenten, direkt mit Ihrem Handelskonto zu kommunizieren. Marktdaten, Positionsprüfungen und Trade-Vorschauen – alles in natürlicher Sprache, ohne Ihr KI-Tool verlassen zu müssen.
Was Sie benötigen
- Ein Capital.com-Konto
- Ihr Capital.com API-Schlüssel
- Ihr individuelles API-Passwort
- Aktivierte Zwei-Faktor-Authentifizierung (2FA)
Hinweis: Sie können alle oben genannten Einstellungen in Ihren Kontoeinstellungen verwalten.
Mobilgeräte werden derzeit nicht unterstützt.
Was ist der Capital.com MCP-Server?
Der MCP-Server ist eine Software, die im Hintergrund auf Ihrem Computer ausgeführt wird. Er dient als sichere Verbindung zwischen Ihrem KI-Assistenten und Ihrem Capital.com-Konto.
Nach der Verbindung kann Ihr KI-Assistent:
- Verfügbare Märkte in den Bereichen Forex, Aktien, Rohstoffe und Indizes durchsuchen.
- Ihre offenen Positionen, Working Orders und Ihren Kontostand anzeigen.
- Historische Kurse und andere Marktdaten abrufen.
- Trades in der Vorschau anzeigen und platzieren – Ihre Bestätigung ist dabei jedes Mal erforderlich.
Sie bleiben vollständig verantwortlich für alle Trading-Entscheidungen, die mithilfe des MCP-Servers getroffen werden. Überprüfen Sie Trade-Vorschauen immer sorgfältig, bevor Sie diese bestätigen.
Vor dem Start prüfen
Stellen Sie sicher, dass Sie alles installiert haben, was Sie benötigen. Wenn Sie eine der folgenden Fragen mit „Nein“ beantworten, folgen Sie dem entsprechenden Link, bevor Sie fortfahren.
| Prüfen | Ja | Nein |
|---|---|---|
| Haben Sie ein Capital.com-Konto? | Weiter | Konto erstellen |
| Haben Sie Ihr bevorzugtes KI-Tool installiert? | Weiter | Einige Vorschläge: Claude Code, Claude Desktop, Codex, Cursor, Windsurf. |
| Verwenden Sie einen Mac oder Windows? | Weiter | Mobilgeräte werden derzeit nicht unterstützt. |
Claude Desktop: Kurzanleitung zur Einrichtung
Wenn Sie keine ausführliche Anleitung benötigen, finden Sie hier die Kurzversion für Claude Chat auf dem Desktop.
- Rufen Sie Ihre API-Zugangsdaten ab.
- Melden Sie sich in den Einstellungen Ihres Capital.com-Kontos an und rufen Sie Ihr API-Passwort ab.
- Laden Sie den MCP von GitHub herunter.
- Die Website lautet: https://github.com/capital-com-sv/capital-mcp
- Öffnen Sie das MCPB-Bundle.
- Doppelklicken Sie auf das Bundle, um es zu starten, oder ziehen Sie die Datei einfach in Ihr Claude-Desktop-Fenster.
- Geben Sie Ihre API-Zugangsdaten ein.
- Claude Desktop fordert Sie auf, Ihre API-Zugangsdaten einzugeben. Geben Sie diese ein und wählen Sie „Installieren“. Vergessen Sie nicht, den MCP zu aktivieren.
- Starten Sie Claude neu.
- Beenden Sie die Anwendung vollständig und öffnen Sie sie erneut. Testen Sie anschließend die Verbindung mit der Eingabe: „List my accounts“.
Vollständige Einrichtungsanleitung
Schritt 1 – Erstellen Sie Ihre API-Zugangsdaten.
In Ihrem Capital.com-Konto:
- Aktivieren Sie 2FA, falls Sie dies noch nicht getan haben. Einstellungen → Zwei-Faktor-Authentifizierung.
- Neuen API-Schlüssel generieren. Einstellungen → API-Integrationen → API-Schlüssel generieren.
- Vergeben Sie eine Bezeichnung für Ihren Schlüssel, z. B. MCP-Server.
- Legen Sie Ihr API-Passwort fest.
Lesen Sie dies, bevor Sie etwas eingeben: Sie erstellen ein neues Passwort speziell für den API-Zugriff. Es ist nicht mit Ihrem Capital.com-Login-Passwort verknüpft. Wählen Sie am besten ein Passwort, das Sie sich merken können, und notieren Sie es. Verwenden Sie hier nicht erneut Ihr Anmeldepasswort. Die Verwechslung Ihres Anmeldepassworts mit Ihrem API-Passwort ist ein häufiger Einrichtungsfehler.
- Geben Sie Ihren 2FA-Code ein und klicken Sie auf „Generieren“.
- Kopieren Sie Ihren API-Schlüssel und bestätigen Sie Ihr API-Passwort erneut. Beides wird nur einmal angezeigt. Sie benötigen beides später. Sobald Sie diesen Bildschirm schließen, werden beide Informationen nicht mehr angezeigt.
Bewahren Sie diese Informationen vertraulich auf. Fügen Sie diese nicht in Chat-Oberflächen ein, geben Sie sie nicht an andere Personen weiter und speichern Sie sie nicht in einem gemeinsam genutzten Dokument. Jeder, der über diese Daten verfügt, kann über die API auf Ihr Handelskonto zugreifen.
Schritt 2 – Laden Sie den MCP herunter.
Der Capital.com MCP-Server ist Open Source und in einem öffentlichen GitHub-Repository verfügbar. Bevor Ihr KI-Tool ihn verwenden kann, benötigen Sie eine Kopie des Codes auf Ihrem Computer.
Laden Sie den MCP-Code von https://github.com/capital-com-sv/capital-mcp auf Ihren Computer herunter.
Schritt 3 – Verbinden Sie Ihren MCP mit Ihrem KI-Tool.
Jedes KI-Tool verbindet sich etwas anders mit dem MCP. Die Verbindung mit Claude Desktop wird hier erläutert. Informationen zur Verbindung mit anderen Plattformen finden Sie hier.
Für Claude Desktop doppelklicken Sie auf die MCPB-Datei, um sie zu starten, oder ziehen Sie die Datei einfach in Ihr Claude-Desktop-Fenster.
Sie sehen das folgende Popup-Fenster in Ihrer Claude-Desktop-Anwendung. Installieren Sie den MCP und aktivieren Sie ihn.
Schritt 4 – Geben Sie Ihre Zugangsdaten ein und richten Sie Ihre Umgebung ein.
Geben Sie die in Schritt 1 erhaltenen Zugangsdaten in die Konfigurationsfelder ein.
| Wert | Herkunft |
|---|---|
| API-Schlüssel | Ihr API-Schlüssel aus Schritt 1 |
| CAP_IDENTIFIER | Ihre Capital.com-E-Mail-Adresse |
| CAP_API_PASSWORD | Ihr individuelles API-Passwort aus Schritt 1 |
Schritt 5 – Starten Sie Ihr KI-Tool neu und testen Sie die Verbindung.
Starten Sie Ihr KI-Tool neu und testen Sie die folgenden Eingaben einzeln, um zu überprüfen, ob die Verbindung funktioniert.
Melden Sie mich bei meinem Capital.com-Konto an
Liste meine Konten auf.
Suche nach Bitcoin-Märkten.
So platzieren Sie einen Trade
Jeder über den MCP-Server platzierte Trade folgt drei obligatorischen Schritten. Der Server erzwingt diesen Ablauf – Sie können keine Schritte überspringen.
1. Vorschau
Bitten Sie Ihren KI-Assistenten, eine Trade-Vorschau zu erstellen:
Vorschau für den Kauf von 1.5 SILVER mit Stop bei 24.50 anzeigen
Der Assistent gibt einen vollständigen Trade-Vorschlag und eine eindeutige preview_id zurück. Lesen Sie alle Details sorgfältig, bevor Sie fortfahren.
2. Prüfen
Prüfen Sie vor der Bestätigung:
- Ist das Instrument korrekt? (Codes unterscheiden zwischen Groß- und Kleinschreibung: SILVER, nicht silver)
- Entspricht die Positionsgröße Ihren Vorstellungen?
- Sind die Stop- und Limit-Levels korrekt?
- Ist das Risiko für Ihre Kontogröße angemessen?
Wenn etwas nicht stimmt, brechen Sie den Vorgang ab. Fordern Sie eine neue Vorschau mit den korrigierten Parametern an.
3. Bestätigen
Senden Sie Folgendes nur, wenn Sie mit der Vorschau zufrieden sind:
Execute position with preview_id abc123 confirm=true
Ohne eine gültige preview_id kann kein Trade platziert werden. Jede ID kann nur einmal verwendet werden und läuft nach der Ausführung ab.
Bevor Sie zu einem Live-Konto wechseln
Gehen Sie zunächst diese Checkliste durch:
- Alle drei Testeingaben aus Schritt 5 haben gültige Daten zurückgegeben.
- Sie haben im Demomodus mindestens einen Trade erfolgreich in der Vorschau angezeigt und bestätigt.
- Sie verstehen die Bedeutung jedes Feldes in der Trade-Vorschau.
- Sie haben CAP_ENV bewusst auf live und CAP_ALLOW_TRADING bewusst auf true gesetzt.
- Sie haben die Allgemeinen Geschäftsbedingungen sowie die Bedingungen für den elektronischen Handel von Capital.com gelesen.
Um einzuschränken, auf welchen Märkten der Server traden kann, fügen Sie Instrumentencodes zu CAP_ALLOWED_EPICS hinzu (z. B. SILVER,GOLD,EURUSD). Lassen Sie das Feld leer, um alle Märkte Ihres Kontos zuzulassen.
Was kann ich meinen KI-Assistenten fragen?
Überprüfen Sie Ihr Konto.
Melden Sie mich bei meinem Konto an
Liste meine Konten auf.
Überprüfe den Status meiner Capital.com-Verbindung.
Märkte analysieren
Suche nach Bitcoin-Märkten
Zeige mir die Marktdetails für EURUSD.
Rufe historische 1-Stunden-Kurse für GOLD ab.
Überprüfen Sie Ihr Portfolio.
Zeige meine offenen Positionen an
Liste meine Working Orders auf.
Überprüfe mein Portfolio-Exposure.
Einen Trade platzieren (zunächst im Demomodus)
Vorschau für den Kauf von 1.5 SILVER mit Stop bei 24.50 anzeigen
Erstellen Sie einen Trade-Vorschlag für GOLD mit 1 % Risiko
Execute position with preview_id abc-123 confirm=true
Close position DEAL_ID confirm=true
Fehlerbehebung
Führen Sie zunächst den Verbindungscheck aus. Bitten Sie Ihren KI-Assistenten: Überprüfe den Status meiner Capital.com-Verbindung. Die Antwort zeigt Ihnen in der Regel, woran das Problem liegt.
| Was Sie sehen | Wahrscheinlichste Ursache | Lösung |
|---|---|---|
| „Authentifizierung fehlgeschlagen“ oder „Sitzung abgelaufen“ | CAP_API_PASSWORD ist auf Ihr Login-Passwort statt auf das individuelle API-Passwort gesetzt, das Sie in Schritt 1 erstellt haben | Verwenden Sie das Passwort, das Sie beim Erstellen des API-Schlüssels festgelegt haben, nicht Ihr Website-Login-Passwort. |
| Rate-Limit überschritten | Es wurden zu viele Anfragen in kurzer Zeit gesendet. | Warten Sie 30–60 Sekunden und versuchen Sie es erneut. |
| zsh: event not found (nur Mac) | Ihr API-Passwort enthält ein Ausrufezeichen (!) | Schließen Sie den Passwortwert in der Konfiguration in einfache Anführungszeichen ein: 'yourPassword!Here' |
| Server antwortet nicht / Server startet nicht | Falscher Python-Pfad oder der Server wurde nicht korrekt installiert. | Öffnen Sie das Terminal und führen Sie python -m capital_mcp.server direkt aus – die Fehlermeldung ist dann lesbar. |
| Weniger als 36 Tools werden angezeigt. | Der Server wurde gestartet, aber die Konfiguration enthält einen Fehler. | Prüfen Sie: (1) alle Platzhalter wurden durch echte Werte ersetzt, (2) keine fehlenden ", ,-Zeichen{ }, (3) der Python-Pfad verweist auf den venv-Ordner und nicht auf das System-Python. |
| Keine Antwort auf Eingaben. | Die Konfigurationsdatei wurde nicht gespeichert oder der KI-Assistent wurde nicht vollständig neu gestartet. | Beenden Sie Ihren KI-Assistenten vollständig und starten Sie ihn erneut – schließen Sie nicht nur das Fenster. |
| 401 Unauthorized | Der API-Schlüssel ist abgelaufen oder wurde widerrufen. | Gehen Sie in Capital.com zu Einstellungen → API-Integrationen und generieren Sie einen neuen Schlüssel. |
| Umgebungsinkonsistenz | CAP_ENV ist auf live gesetzt, die Zugangsdaten gehören jedoch zu einem Demokonto | Aktualisieren Sie CAP_ENV in Ihrer Konfigurationsdatei entsprechend Ihrem Kontotyp. |
Sie kommen nicht weiter? Senden Sie eine Support-Anfrage und geben Sie an, welchen KI-Assistenten Sie verwenden, welches Betriebssystem Sie nutzen und die vollständige Fehlermeldung.
Häufig gestellte Fragen
Benötige ich einen kostenpflichtigen KI-Assistenten? Einige KI-Assistenten erfordern ein kostenpflichtiges Abonnement, um MCP-Funktionen nutzen zu können. Claude Desktop benötigt beispielsweise einen kostenpflichtigen Tarif, um MCP-Connectoren zu aktivieren. Der Capital.com MCP-Server selbst ist kostenlos.
Benötige ich ein Live-Trading-Konto? Nein. Der Server funktioniert auch mit einem Demokonto, und wir empfehlen, dort zu beginnen.
Ist mein Capital.com-Login-Passwort dasselbe wie CAP_API_PASSWORD? Nein. Dabei handelt es sich um zwei unterschiedliche Passwörter. CAP_API_PASSWORD ist ein neues Passwort, das Sie speziell beim Erstellen Ihres API-Schlüssels festlegen. Wenn Sie hier Ihr Login-Passwort verwenden, schlägt die Authentifizierung fehl.
Kann die KI einen Trade ohne mein Wissen platzieren? Nein. Jeder Trade erfordert zunächst eine Vorschau und anschließend eine separate Bestätigungsnachricht mit confirm=true. Ohne beides kann der Server keinen Trade ausführen. Die Preview-ID ist nur einmal verwendbar und läuft unmittelbar nach der Ausführung ab.
Was ist CAP_ALLOW_TRADING und sollte ich den Wert ändern? Es handelt sich um einen Sicherheitsschalter. Ist der Wert auf false gesetzt, kann der Server Marktdaten und Kontoinformationen anzeigen, jedoch keine Trades platzieren. Setzen Sie ihn erst auf true, nachdem Sie alles im Demomodus getestet haben und bereit sind, mit echtem Geld zu traden.
Wofür dient CAP_ALLOWED_EPICS? Damit wird eingeschränkt, welche Instrumente der Server traden kann. Lassen Sie das Feld leer, um alle Märkte Ihres Kontos zuzulassen. Fügen Sie eine durch Kommas getrennte Liste hinzu (z. B. SILVER,GOLD,EURUSD), um die Auswahl einzuschränken.
Ich sehe weniger als 36 Tools in meinem KI-Assistenten. Was ist das Problem? Bitten Sie Ihren KI-Assistenten: Überprüfe den Status meiner Capital.com-Verbindung. Die häufigsten Ursachen sind ein Formatierungsfehler in der JSON-Konfiguration oder ein Python-Pfad, der auf das System-Python statt auf den venv-Ordner verweist.
Sind meine Trading-Daten sicher? Der Server wird lokal auf Ihrem Computer ausgeführt. Ihre Zugangsdaten werden ausschließlich in Ihrer lokalen Konfigurationsdatei gespeichert und niemals an Dritte übermittelt. Die gesamte Kommunikation mit Capital.com erfolgt über HTTPS-Verschlüsselung.
Kann ich den Server auf zwei Computern verwenden? Ja. Wiederholen Sie Schritt 2 auf dem zweiten Computer und verwenden Sie dabei dieselben API-Zugangsdaten aus Schritt 1.
Kann ich mehr als ein Capital.com-Konto verbinden? Der Server verbindet sich jeweils nur mit einem Konto. Um zu wechseln, aktualisieren Sie die vier CAP_-Werte in Ihrer Konfigurationsdatei und starten Sie Ihren KI-Assistenten neu.
Haftungsausschluss – Nutzung der Capital.com Public API mit Drittanbieter-Tools
Drittanbieter-Integration
Diese Seite beschreibt, wie Kunden die Capital.com Public API mit Software, Tools oder Integrationen von Drittanbietern verbinden können, einschließlich solcher, die auf künstlicher Intelligenz oder großen Sprachmodellen („LLMs“) basieren. Eine solche Software, ein solches Tool oder eine solche Integration von Drittanbietern ist unabhängig von Capital.com und ist kein Bestandteil der Dienstleistungen von Capital.com. Capital.com kontrolliert, entwickelt, unterstützt oder übernimmt keine Haftung für Software von Drittanbietern, deren Funktionalität, Ergebnisse oder Folgen, die sich aus ihrer Nutzung ergeben könnten. Die Nutzung von Drittanbieter-Tools oder Integrationen in Verbindung mit der Capital.com Public API erfolgt ausschließlich auf Ihr eigenes Risiko. Sie sind verantwortlich für die Überprüfung der Bedingungen, Datenschutzrichtlinien und Datenverarbeitungspraktiken von jedem Drittanbieter-Tool, das Sie verwenden.
Nutzung der Capital.com Public API
Die Nutzung der Capital.com Public API erfolgt ausschließlich auf Ihr eigenes Ermessen und Risiko. Capital.com stellt die Public API für Informations- und Handelszwecke zur Verfügung, empfiehlt, unterstützt oder fördert jedoch keine bestimmte Nutzung, Integration oder Handelsstrategie. Sie sind allein verantwortlich dafür, wie Sie auf die API zugreifen und sie nutzen, einschließlich der Parameter aller übermittelten Orders, der Konfiguration aller verbundenen Tools oder Systeme und der Interpretation aller empfangenen Daten. Capital.com übernimmt keine Haftung für Verluste oder unbeabsichtigte Folgen, die aus Ihrer Nutzung der API entstehen, unabhängig davon, ob der Zugriff direkt oder über Drittanbieter-Tools erfolgt. Die Verfügbarkeit, Funktionalität und Spezifikationen der API können jederzeit ohne vorherige Ankündigung geändert, eingeschränkt, ausgesetzt oder eingestellt werden. Die Nutzung der Public API unterliegt den Allgemeinen Geschäftsbedingungen und den Bedingungen für den elektronischen Handel von Capital.com, die Sie vor der Nutzung der API sorgfältig lesen sollten.
Reiner Ausführungsdienst und keine Anlageberatung
Capital.com bietet seine Dienstleistungen ausschließlich auf Ausführungsbasis an. Der Handel mit Finanzinstrumenten birgt ein erhebliches Verlustrisiko. Nichts auf dieser Seite, in der Public API oder in Software oder Integrationen von Drittanbietern stellt eine Anlageberatung, eine persönliche Empfehlung oder eine Aufforderung zum Kauf oder Verkauf eines Finanzinstruments dar. Dies umfasst alle Ausgaben, Signale, Vorschläge oder Analysen, die von KI, LLM-basierten oder anderen automatisierten Tools generiert werden. Alle Handelsentscheidungen, einschließlich automatisierter oder algorithmischer Aktivitäten, treffen Sie auf Ihr eigenes Risiko und bleiben Ihre alleinige Verantwortung.Capital.com kontrolliert nicht die Ausgaben von KI- oder LLM-basierten Tools von Drittanbietern, die mit der Public API verbunden sind, und kann nicht garantieren, dass solche Tools keine Inhalte generieren, die als Anlageberatung oder persönliche Empfehlung ausgelegt werden könnten. Eine solche Ausgabe wird nicht von oder im Namen von Capital.com bereitgestellt und sollte nicht als Beratung angesehen werden.
Risiken des automatisierten und algorithmischen Handels
Die Nutzung der Public API in Verbindung mit automatisierten oder algorithmischen Handelstools birgt zusätzliche Risiken, einschließlich, aber nicht beschränkt auf: schnelle Ausführung von Orders ohne menschliche Überprüfung oder Intervention, Systemfehler, Softwareausfälle oder Verbindungsprobleme, Ausführung zu Preisen, die erheblich von den erwarteten Preisen abweichen, und unbeabsichtigte oder fehlerhafte Orders, die aus falsch konfigurierten Tools oder Parametern resultieren. Capital.com ist nicht für Verluste verantwortlich, die aus solchen Risiken oder aus der Interaktion zwischen seinen Systemen und Tools von Drittanbietern entstehen. Die Wertentwicklung in der Vergangenheit und alle von automatisierten Tools generierten Ausgaben sind keine Indikatoren für zukünftige Ergebnisse.
Wenn KI- oder LLM-basierte Tools verwendet werden, um Marktdaten oder Preisinformationen abzurufen, kann es zu einer Verzögerung zwischen dem vom Tool kommunizierten Preis und dem Preis kommen, zu dem eine daraus resultierende Order ausgeführt wird. Alle über die Public API platzierten Orders werden als Market-Orders ausgeführt. Der Ausführungspreis kann daher von jedem Preis abweichen, der zum Zeitpunkt einer Anfrage angezeigt wird. Capital.com strebt die bestmögliche Ausführung gemäß seinen Verpflichtungen an. Wir übernehmen keine Haftung für Preisunterschiede, die auf Latenzzeiten durch Drittanbieter-Tools oder -Systeme außerhalb unseres Einflussbereichs zurückzuführen sind.
Verbotene Nutzung
Die Nutzung der Public API und aller verbundenen Tools ist nicht gestattet, um die Capital.com-Plattform zu manipulieren, Preise oder Latenzzeiten auszunutzen, sich an Marktmissbrauch zu beteiligen oder sich einen unfairen Vorteil zu verschaffen. Capital.com behält sich das Recht vor, den API-Zugang und/oder Ihr Konto einzuschränken, auszusetzen oder zu kündigen, wenn das Unternehmen begründeterweise der Ansicht ist, dass ein solcher Missbrauch stattgefunden hat oder wahrscheinlich stattfinden wird. Kunden dürfen Dritten nicht gestatten, über ihr Konto nach eigenem Ermessen zu verfügen.
Ihre Verantwortlichkeiten
Sie sind dafür verantwortlich, dass Ihre Nutzung der Capital.com-Plattform, der Public API und aller Drittanbieter-Tools oder -Integrationen den Allgemeinen Geschäftsbedingungen von Capital.com, den Bedingungen für den elektronischen Handel und allen geltenden Gesetzen und Vorschriften in Ihrer Gerichtsbarkeit entspricht. Sie sollten vor der Nutzung sorgfältig abwägen, ob automatisierte Handelstools für Ihre Umstände, Erfahrungen und Risikotoleranz geeignet sind. Capital.com empfiehlt ausdrücklich, dass Sie alle automatisierten Tools oder Integrationen gründlich mit einem Demokonto testen, bevor Sie diese mit einer Live-Handelsumgebung verbinden.