Anbindung an KI-Agenten

MCP ist ein offener Weg, einem Modell Zugriff auf eine Datenquelle zu geben: Der Agent sieht eine Liste von Werkzeugen und ruft sie selbst auf, wenn er sie für die Antwort braucht. Unser Server ist ein dünner Aufsatz auf derselben maschinellen Schnittstelle, die auf der Seite „Für Entwickler“ beschrieben ist: Er bringt weder eigene Daten noch eigene Last mit und arbeitet mit Ihrem Leserschlüssel.

Installation

pip install tradealmanac-mcp

# den Schlüssel vor jedem Editor prüfen
TRADEALMANAC_API_KEY=afk_… tradealmanac-mcp --check

npx -y @tradealmanac/mcp-server --tools

Die beiden Implementierungen sind gleichwertig: Werkzeuge, Obergrenzen und Antworten sind identisch, das Manifest ist gemeinsam. Wählen Sie diejenige, deren Sprache bereits auf Ihrem Rechner installiert ist. Abhängigkeiten hat keine von beiden – der Server läuft in der Umgebung Ihres Editors, und fremde Pakete dorthin zu ziehen ist unnötig.

Claude Desktop

{
  "mcpServers": {
    "tradealmanac": {
      "command": "tradealmanac-mcp",
      "env": { "TRADEALMANAC_API_KEY": "afk_…" }
    }
  }
}

Die Datei liegt in den Einstellungen der Anwendung, im Abschnitt „Developer“. Starten Sie Claude Desktop nach der Änderung neu – die Liste der Werkzeuge wird nur einmal beim Start gelesen.

Cursor

{
  "mcpServers": {
    "tradealmanac": {
      "command": "npx",
      "args": ["-y", "@tradealmanac/mcp-server"],
      "env": { "TRADEALMANAC_API_KEY": "afk_…" }
    }
  }
}

Eine Konfiguration im Projekt gilt nur dort, im Home-Verzeichnis – überall. Denselben Block verstehen auch andere Agenten-Editoren: Das Konfigurationsformat von MCP ist einheitlich.

Claude Code

claude mcp add tradealmanac \
  --env TRADEALMANAC_API_KEY=afk_… -- tradealmanac-mcp

Per Adresse, ohne Installation

Derselbe Server antwortet unter einer Adresse — für Clients, die einen Server per Link anbinden: Fügen Sie sie in das Feld für die MCP-Serveradresse ein. Werkzeuge, Obergrenzen und Antworten sind dieselben wie bei den Paketen. Der Schlüssel wird im Header Authorization übergeben; ohne Schlüssel antworten Indikatoren, Kalendereffekte und Ranglisten, die übrigen Werkzeuge brauchen einen Schlüssel — der Testschlüssel genügt.

https://tradealmanac.com/mcp

claude mcp add --transport http tradealmanac https://tradealmanac.com/mcp \
  --header "Authorization: Bearer afk_…"

Auch unter der Adresse sind die Werkzeugbeschreibungen standardmäßig englisch; mit ?lang=ru in der Adresse erscheinen sie auf Russisch.

Sie möchten nichts von Hand einrichten? Auf der Seite „Mit dem KI-Assistenten verbinden“ finden Sie eine Schaltfläche für Claude, ChatGPT, Cursor und weitere Clients.

Sie möchten den Server neben dem Ihres Brokers nutzen? Auf der Seite „Rezepte“ steht, wie Sie beide verbinden, samt drei fertigen Anfragen.

Werkzeuge, die einen Schlüssel brauchen, akzeptieren entweder einen Schlüssel oder die Anmeldung per Einwilligung in der App. Ein Client, der die Anmeldung unterstützt (Claude, ChatGPT), öffnet die Einwilligungsseite auf dieser Website selbst; dann ist in den Client-Einstellungen kein Schlüssel nötig. Der erteilte Zugriff ist in Konto → Verbundene Agenten sichtbar und kann dort widerrufen werden.

Der Server kann auch persönliche Werkzeuge anbieten – Beobachtungslisten und Benachrichtigungen. Sie brauchen eigene Berechtigungen, „Beobachtungslisten“ und „Benachrichtigungen“, die Sie auf der Einwilligungsseite sehen und auswählen; bietet der Server sie nicht an, zeigt die Seite keine solchen Berechtigungen. Was Sie nicht erlaubt haben, rührt der Agent nicht an, und ein Schlüssel allein öffnet keine persönlichen Daten.

Mit der eigenen Berechtigung „Demokonto“ kann der Server dem Agenten außerdem erlauben, Ihr Demokonto zu lesen und dort Demo-Aufträge aufzugeben; das Geld ist virtuell, und es wird kein echter Auftrag an einen Broker oder eine Börse gesendet.

Sprache des Servers

Titel und Beschreibungen der Werkzeuge, die Hinweise des Servers und die Fehlermeldungen sind standardmäßig englisch. Eine zweite Sprache ist eingebaut: Ergänzen Sie die Umgebung des Servers um die Variable aus dem Block unten, und dieselben Texte kommen in der Sprache der Ausgabe ru. Die Namen der Werkzeuge, die Namen der Argumente und die Felder der Antwort hängen nicht von der Sprache ab.

"env": {
  "TRADEALMANAC_API_KEY": "afk_…",
  "TRADEALMANAC_MCP_LANG": "ru"
}

Der Schlüssel

Den Schlüssel erhalten Sie kostenlos im persönlichen Bereich, Abschnitt „API“. Für den ersten Versuch gibt es einen Testschlüssel: Sein Kontingent wird nicht verbraucht, die Antwort ist ein Tagesabzug, frische Zahlen zeigt er deshalb nicht.

TRADEALMANAC_API_KEY=afk_sandbox_tradealmanac_demo tradealmanac-mcp --check

Vier Szenarien

• Eine Auswahl zusammenstellen — „Finde Wertpapiere des Öl- und Gassektors mit einer Dividendenrendite über 8 % und einem KGV unter 6 und zeige sie als Tabelle.“ Der Agent holt sich selbst die Branchencodes, gleicht die Einheiten der Kennzahlen ab und ruft die Auswahl auf.
• Dividenden vergleichen — „Vergleiche die Dividendenhistorie von Sberbank und Lukoil über fünf Jahre und sage, bei wem die Ausschüttungen regelmäßiger sind.“ Die Antwort kommt mit den Status der Bekanntgabe: Eine Prognose muss der Agent als Prognose bezeichnen.
• Den Kalender exportieren — „Exportiere die nächsten Dividendenstichtage bis zum Jahresende als CSV-Tabelle.“ Der Kalender wird seitenweise per Cursor abgerufen, das Speichern der Datei übernimmt der Editor selbst.
• Nach Stimmung und Saisonalität fragen — „Wie ist die Stimmung an den Märkten Russlands und der USA gerade, und wie verhält sich der Moskauer-Börse-Index üblicherweise im Januar?“ Die Indikatoren werden von einem gemeinsamen Werkzeug anhand der Kennung gelesen, ein Kalendereffekt kommt mit Anzahl der Beobachtungen und Signifikanz – die Statistik der Vergangenheit darf der Agent nicht als Prognose ausgeben.

Was der Agent hier nicht bekommt

Kurse, Kerzen und das Verzeichnis der Moskauer Börse gehören nicht zum Schnittstellenvertrag – weder in Echtzeit noch verzögert noch aus dem Speicher; Daten der Weltmärkte gibt es ebenfalls nicht. Ein Werkzeug „Aktienkurs“ wird es im Server nicht geben, und das ist keine Lücke, sondern eine Lizenzgrenze. Der Server sagt das dem Modell gleich bei der ersten Verbindung offen: Ein Agent, der nichts zu antworten hat, muss das sagen, statt eine Zahl von anderswo einzusetzen und mit unserem Namen zu versehen.

Obergrenzen

Das Kontingent des Servers ist Ihr eigenes – dasselbe wie das des Schlüssels: 60 Aufrufe pro Minute und 1 000 pro Tag bei einem kostenlosen Schlüssel. Ist es erschöpft, kommt die Ablehnung 429 mit der Anzahl der Sekunden bis zum nächsten Versuch, und der Server wiederholt die Anfrage nicht selbst: Eine Wiederholung in ein erschöpftes Kontingent macht aus einer Obergrenze einen Sturm. Die Antwort eines Werkzeugs ist im Umfang begrenzt; ist die Auswahl länger, enthält sie einen Vermerk, wie viele Einträge verborgen sind – ein Teil der Auswahl wird nie als das Ganze ausgegeben.

Fragen zum Zugang und Bitten um höhere Limits richten Sie bitte über Kontakt an uns.