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 Public API mit Drittanbieter-Tools
Drittanbieter-Integration
Diese Seite beschreibt, wie Kunden die Public API mit Drittanbieter-Software, -Tools oder -Integrationen verbinden können, einschließlich solcher, die auf künstlicher Intelligenz oder Large Language Models („LLMs“) basieren. Jegliche derartige Drittanbieter-Software, -Tools oder -Integrationen sind unabhängig von Capital.com und stellen keinen Bestandteil der Dienstleistungen von Capital.com dar. Capital.com kontrolliert oder entwickelt keine Drittanbieter-Software, unterstützt diese nicht und übernimmt keinerlei Haftung für deren Funktionalität, Ausgaben oder Ergebnisse, die sich aus ihrer Nutzung ergeben. Die Nutzung von Drittanbieter-Tools oder -Integrationen in Verbindung mit der Public API erfolgt vollständig auf eigenes Risiko. Sie sind dafür verantwortlich, die Bedingungen, Datenschutzrichtlinien und Datenverarbeitungspraktiken aller von Ihnen genutzten Drittanbieter-Tools zu prüfen.
Nutzung der Public API
Die Nutzung der Public API erfolgt vollständig nach eigenem Ermessen und auf eigenes Risiko. Capital.com stellt die Public API zu Informations- und Trading-Zwecken zur Verfügung, empfiehlt, unterstützt oder fördert jedoch keine bestimmte Nutzung, Integration oder Trading-Strategie. Sie sind allein dafür verantwortlich, wie Sie auf die API zugreifen und sie nutzen, einschließlich der Parameter eingereichter Orders, der Konfiguration verbundener Tools oder Systeme sowie der Auslegung der empfangenen Daten. Capital.com übernimmt keine Haftung für Verluste oder unbeabsichtigte Folgen, die sich aus Ihrer Nutzung der API ergeben, unabhängig davon, ob diese direkt oder über Drittanbieter-Tools erfolgt. 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 sowie den Bedingungen für den elektronischen Handel von Capital.com, die Sie vor der Nutzung der API sorgfältig lesen sollten.
Execution-Only-Service – keine Anlageberatung
Capital.com erbringt seine Dienstleistungen ausschließlich auf Execution-Only-Basis. Das Trading mit Finanzinstrumenten ist mit erheblichen Verlustrisiken verbunden. Nichts auf dieser Seite, in der Public API oder in Drittanbieter-Software oder -Integrationen 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 Trading-Entscheidungen, einschließlich automatisierter oder algorithmischer Aktivitäten, erfolgen auf eigenes Risiko und bleiben Ihre alleinige Verantwortung.
Risiken des automatisierten und algorithmischen Tradings
Die Nutzung der Public API in Verbindung mit automatisierten oder algorithmischen Trading-Tools bringt zusätzliche Risiken mit sich, darunter: die schnelle Ausführung von Orders ohne menschliche Überprüfung oder Eingriff, Systemfehler, Softwareausfälle oder Verbindungsprobleme, Ausführungen zu Preisen, die erheblich von den erwarteten Preisen abweichen, sowie unbeabsichtigte oder fehlerhafte Orders infolge falsch konfigurierter Tools oder Parameter. Capital.com übernimmt keine Verantwortung für Verluste, die aus solchen Risiken oder aus der Interaktion zwischen seinen Systemen und Drittanbieter-Tools entstehen. Vergangene Wertentwicklungen und von automatisierten Tools generierte Ausgaben sind kein Indikator für zukünftige Ergebnisse.
Verbotene Nutzung
Die Public API und alle verbundenen Tools dürfen nicht verwendet werden, um die Plattform zu manipulieren, Preisstellungen oder Latenzen auszunutzen, Marktmissbrauch zu betreiben 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 nach vernünftigem Ermessen ein solcher Missbrauch stattgefunden hat oder wahrscheinlich stattfinden wird. Kunden dürfen Dritten keine diskretionäre Kontrolle über ihr Konto gestatten.
Ihre Verantwortlichkeiten
Sie sind dafür verantwortlich sicherzustellen, dass Ihre Nutzung der Plattform, der Public API sowie aller Drittanbieter-Tools oder -Integrationen mit den Allgemeinen Geschäftsbedingungen von Capital.com sowie allen geltenden Gesetzen und Vorschriften in Ihrer Rechtsordnung übereinstimmt. Sie sollten sorgfältig prüfen, ob automatisierte Trading-Tools angesichts Ihrer persönlichen Umstände, Ihrer Erfahrung und Ihrer Risikotoleranz für Sie geeignet sind, bevor Sie sie nutzen. Capital.com empfiehlt dringend, automatisierte Tools oder Integrationen vor der Verbindung mit einer Live-Trading-Umgebung umfassend mit einem Demokonto zu testen.