Schnellstart

Ikrames stellt einen MCP-Server bereit, damit ein Agent in deinem Arbeitsbereich arbeiten kann: lesen, was da ist, Guthaben für die Erzeugung ausgeben und das Ergebnis holen.

Er ist für Programme gebaut, nicht für Menschen. Alles hier braucht einen API-Schlüssel, und den legst du selbst an — siehe Einen Schlüssel anlegen. Wenn du die App selbst suchst, fang bei der Übersicht an.

Ein Schlüssel gehört zu genau einem Arbeitsbereich. Jedes Werkzeug gilt in diesem Arbeitsbereich, und der Arbeitsbereich ist nie ein Argument, das du übergibst — ein Aufrufer kann ihn also nicht falsch setzen.

Verbinden

Zwei Header sind bei jedem Aufruf Pflicht. Der Protokoll-Header ist nicht freiwillig: ohne ihn weist der Transport die Anfrage ab, bevor dein Schlüssel überhaupt gelesen wird.

Authorization: Bearer <DEIN_SCHLUESSEL>
Mcp-Protocol-Version: 2025-06-18

Claude Desktop

{
  "mcpServers": {
    "ikrames": {
      "type": "http",
      "url": "https://ikrames.com/api/mcp",
      "headers": {
        "Authorization": "Bearer <DEIN_SCHLUESSEL>"
      }
    }
  }
}

Cursor

Dieselbe Form, in ~/.cursor/mcp.json für alle Projekte oder in .cursor/mcp.json innerhalb eines Projekts.

{
  "mcpServers": {
    "ikrames": {
      "type": "http",
      "url": "https://ikrames.com/api/mcp",
      "headers": {
        "Authorization": "Bearer <DEIN_SCHLUESSEL>"
      }
    }
  }
}

Die projektlokale Datei liegt in deinem Repository. Ein dort eingefügter Schlüssel ist ein git add . davon entfernt, öffentlich zu sein — leg ihn in die Datei je Benutzer, oder halte die Projektdatei aus der Versionsverwaltung heraus.

curl

curl -s https://ikrames.com/api/mcp \
  -H "Authorization: Bearer $IKRAMES_KEY" \
  -H "Content-Type: application/json" \
  -H "Mcp-Protocol-Version: 2025-06-18" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0", "id": 1, "method": "initialize",
    "params": {
      "protocolVersion": "2025-06-18",
      "capabilities": {},
      "clientInfo": { "name": "curl", "version": "1" }
    }
  }'

{
  "result": {
    "protocolVersion": "2025-06-18",
    "capabilities": { "tools": { "listChanged": true } },
    "serverInfo": { "name": "ikrames", "version": "1.0.0" }
  },
  "jsonrpc": "2.0", "id": 1
}

Antworten kommen entweder als gewöhnliches JSON oder als ein einzelner Server-Sent-Event-Rahmen. Schick also Accept: application/json, text/event-stream mit und sei darauf gefasst, ein vorangestelltes data: abzustreifen.