Einen KI-Assistenten über MCP verbinden

Bevor du beginnst

1. Ein AlgoVesta-Konto. Die 7-tägige Testversion reicht aus — du brauchst keinen kostenpflichtigen Plan, um dies zu testen.
2. Ein MCP-Client: Claude im Web, auf dem Desktop oder Handy, Claude Code, Cursor, ChatGPT bei einem kostenpflichtigen Plan, Gemini CLI oder alles andere, das Model Context Protocol spricht.
3. Ein Key. Du brauchst keine verbundene Börse, um zu beginnen: Ein Paper-Key nutzt das vollständige Toolset gegen ein virtuelles Guthaben von 5.000 $, sodass du alles einrichten und üben kannst, bevor ein echtes Konto beteiligt ist.

1. Erstelle deinen MCP-Link

1. Öffne das AlgoVesta-Panel und gehe zum Tab MCP Connection
2. Klicke auf Create key, gib ihm ein Label, das angibt, wo er verwendet wird (zum Beispiel claude-desktop oder cursor-laptop)
3. Wähle einen Scope: read nur für Portfolio-Fragen, paper für das vollständige Toolset gegen das virtuelle Guthaben von 5.000 $, oder live für echte Orders
4. Kopiere die angezeigte Adresse. Sie sieht so aus:

https://api.algovesta.com/u/avmcp_<your-key>/mcp

2. Zu Claude hinzufügen

1. Öffne in Claude Settings → Connectors
2. Klicke auf Add custom connector
3. Gib ihm einen Namen (AlgoVesta) und füge deinen MCP-Link in das URL-Feld ein
4. Speichere und starte dann ein neues Gespräch — die Tools erscheinen in der Tool-Liste des Gesprächs

Dieser Connector synchronisiert sich über Claude im Web, auf dem Desktop und auf dem Handy, sodass eine einmalige Einrichtung auch dein Handy abdeckt. Wenn du lieber keine geheime Adresse einfügen möchtest, stellt AlgoVesta außerdem einen Standard-OAuth-2.1-Endpunkt unter https://api.algovesta.com/mcp mit PKCE (S256) und Dynamic Client Registration bereit — richte den Connector stattdessen darauf aus, und du wirst durch einen normalen Browser-Zustimmungsbildschirm geführt.

3. Zu Claude Code hinzufügen

Ein Befehl registriert den Server über streambares HTTP:

claude mcp add --transport http algovesta https://api.algovesta.com/u/avmcp_<your-key>/mcp

Führe anschließend claude mcp list aus, um zu bestätigen, dass der Server registriert und erreichbar ist.

4. Zu Cursor oder ChatGPT hinzufügen

Cursor liest eine JSON-Konfigurationsdatei. Füge einen Eintrag zu mcp.json hinzu:

{"mcpServers":{"algovesta":{"url":"https://api.algovesta.com/u/avmcp_<your-key>/mcp"}}}

Gemini CLI verwendet denselben Eintrag, nennt das Feld aber httpUrl statt url. Alles andere ist identisch.

ChatGPT unterstützt benutzerdefinierte MCP-Connectors bei kostenpflichtigen Plänen, mit aktiviertem Entwicklermodus in den Einstellungen. Füge den Connector dort hinzu und füge denselben Link ein.

5. Verbindung überprüfen

1. Starte ein neues Gespräch in deinem Client
2. Frage: How is my portfolio?
3. Der Assistent sollte das Tool get_portfolio_context aufrufen und mit deinen tatsächlichen Guthaben und offenen Positionen antworten — bei einem Paper-Key mit dem virtuellen Guthaben von 5.000 $

Wenn er allgemein antwortet, ohne ein Tool aufzurufen, ist der Server nicht verbunden: Der Assistent spricht über Trading im Allgemeinen statt über dein Konto. Überprüfe den Link erneut und starte den Client neu.

Was der Assistent nach der Verbindung tun kann

Zwanzig Tools werden bereitgestellt. Vierzehn davon lesen oder proben und verändern nichts: get_portfolio_context, get_market_price, get_trade_history, compare_venues, simulate_order, list_open_orders, list_strategies, verify_receipt, replay_channel und compile_policy. Sechs davon bewegen Orders: place_order, close_position, modify_position, cancel_order, create_strategy und update_strategy.

Du rufst diese nicht namentlich auf. Frag in einfacher Sprache — "was halte ich gerade?", "was würde mich 0,1 BTC jetzt kosten?", "schließe die Hälfte meiner ETH-Position" — und der Assistent wählt die Tools aus und verkettet sie. Bei jeder eröffneten Position ist ein Stop-Loss erforderlich, und es gibt kein Tool, um ihn nachträglich zu entfernen. Vollständige Schemas für jedes Tool findest du in der Entwicklerdokumentation.

401 unauthorized

Der Key wurde widerrufen, gelöscht, oder die Adresse ist falsch eingegeben. Das ist der häufigste Fehler, wenn der Link von Hand eingefügt oder mit einem angehängten Leerzeichen kopiert wurde. Prüfe, ob der Key im Tab MCP Connection noch existiert; falls ja, lösche ihn und erstelle einen neuen, statt die Zeichenkette zu reparieren.

insufficient_scope

Das Tool, das der Assistent aufzurufen versuchte, benötigt einen höheren Scope, als der Key trägt. Ein read-Key kann place_order nicht aufrufen, und ein paper-Key kann kein echtes Konto erreichen. Scopes sind abgestuft, daher weist ein Tool, das paper benötigt, einen read-Key ab. Akzeptiere entweder die Einschränkung oder erstelle einen neuen Key mit dem Scope, den du tatsächlich brauchst — der Wechsel zu live erfordert einen zweiten Faktor.

user_frozen

Der Kill-Switch ist auf deinem Konto aktiv, was alle Keys auf einmal stoppt. Das ist beabsichtigt: Es ist die Notbremse. Hebe die Sperre im Panel auf, wenn du das Trading fortsetzen möchtest. Wenn du nur einen einzelnen Client trennen wolltest, widerrufe stattdessen diesen einen Key — die anderen funktionieren weiter.

rate_limited

Du hast 60 Anfragen pro Minute auf diesem Key überschritten. Für die teuren Tools gelten strengere Obergrenzen: place_order ist auf 10 pro Minute und replay_channel auf 5 pro Stunde begrenzt. Warte und versuche es erneut. Wenn dies wiederholt auftritt, bedeutet das meist, dass ein Agent in einer Schleife hängt, statt dass du schnell handelst — es lohnt sich zu prüfen, was der Assistent tatsächlich tut, bevor du die Anfragerate erhöhst.