API-Authentifizierung

Um loszulegen, gehe auf die Einstellungsseite deines Projekts und erstelle einen neuen API-Schlüssel.

Jeder Schlüssel ist genau einem Connector zugeordnet. Stelle sicher, dass du ihn in jeder

Anfrage als benutzerdefinierten

X-API-KEY

Header mit sendest.

Ein

HTTP OPTIONS

Request an die API-Base-URL gibt die IDs des Projekts und des Connectors zurück, denen der Schlüssel zugeordnet ist.

Vergiss nicht, deinen API-Schlüssel als benutzerdefinierten Header in jeder Anfrage zu setzen:

X-API-KEY: dein-schlüssel-hier

Du kannst den Gültigkeitsbereich deines Schlüssels mit einer OPTIONS-Anfrage überprüfen:

http request OPTIONS https://core.orbitype.com/api X-API-KEY: dein-schlüssel-hier

Die Antwort enthält die IDs des Projekts und des Connectors:

{ \n  \"projectId\": \"dein-projekt-uuid\", \n  \"connectorId\": \"dein-connector-uuid\" \n}

Erstelle

.cursor/mcp.json

und füge Folgendes ein:

{
  "mcpServers": {
    "orbitype-sql-prod": {
      "url": "https://core.orbitype.com/api/mcp/v1",
      "headers": {
        "X-API-KEY": "${env:ORBITYPE_SQL_API_KEY_PROD}"
      }
    },
    "orbitype-s3-public-prod": {
      "url": "https://core.orbitype.com/api/mcp/v1",
      "headers": {
        "X-API-KEY": "${env:ORBITYPE_S3_PUBLIC_API_KEY_PROD}"
      }
    },
    "orbitype-s3-private-prod": {
      "url": "https://core.orbitype.com/api/mcp/v1",
      "headers": {
        "X-API-KEY": "${env:ORBITYPE_S3_PRIVATE_API_KEY_PROD}"
      }
    }
  }
}

Öffne

~/Library/Application Support/Claude/claude_desktop_config.json

und füge Folgendes in

mcpServers

ein:

{
  "orbitype-sql-prod": {
    "command": "npx",
    "args": [
      "-y",
      "mcp-remote",
      "https://core.orbitype.com/api/mcp/v1",
      "--header",
      "X-API-KEY: <SQL_PROD_KEY>"
    ]
  },
  "orbitype-s3-public-prod": {
    "command": "npx",
    "args": [
      "-y",
      "mcp-remote",
      "https://core.orbitype.com/api/mcp/v1",
      "--header",
      "X-API-KEY: <S3_PUBLIC_PROD_KEY>"
    ]
  },
  "orbitype-s3-private-prod": {
    "command": "npx",
    "args": [
      "-y",
      "mcp-remote",
      "https://core.orbitype.com/api/mcp/v1",
      "--header",
      "X-API-KEY: <S3_PRIVATE_PROD_KEY>"
    ]
  }
}

Orbitype stellt MCP zusätzlich auf Core bereit:

POST https://core.orbitype.com/api/mcp/v1

Die Authentifizierung ist identisch zur REST-API:

X-API-KEY: dein-schlüssel-hier

Ein API-Schlüssel ist immer genau einem Connector zugeordnet. Discovery und Tools sind automatisch auf diesen Connector begrenzt.

Verwende die Standard-JSON-RPC-Methoden:

initialize

tools/list

tools/call

Empfohlener erster Aufruf:

orbitype_get_context

Dieser liefert Projekt-/Connector-Kontext, S3-Prefix (falls vorhanden) und Hinweise zur sicheren Nutzung.

Die Tool-Namen sind Cursor-kompatibel (alphanumerisch + Unterstriche):

SQL

sql_readonly_query

sql_crud_execute

S3

s3_list

s3_put

s3_delete

s3_copy

s3_signed_url

Kontext

orbitype_get_context

Für Shared Buckets erzwingt Orbitype den Connector-Prefix serverseitig bei S3-Aufrufen.

Pfade müssen mit dem Connector-Prefix beginnen (für

path

,

from

,

to

). Ungültige Pfade liefern einen klaren JSON-RPC-Validierungsfehler statt eines unklaren AWS-Fehlers.

Einige Claude-Desktop-Versionen akzeptieren Remote-Konfigurationen mit

url + headers

nicht direkt. Nutze deshalb

mcp-remote

in

~/Library/Application Support/Claude/claude_desktop_config.json

:

{\n  \"mcpServers\": {\n    \"orbitype-sql-prod\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"-y\",\n        \"mcp-remote\",\n        \"https://core.orbitype.com/api/mcp/v1\",\n        \"--header\",\n        \"X-API-KEY: <SQL_PROD_KEY>\"\n      ]\n    }\n  }\n}

Erstelle oder aktualisiere

.cursor/mcp.json

:

{\n  \"mcpServers\": {\n    \"orbitype-sql-prod\": {\n      \"url\": \"https://core.orbitype.com/api/mcp/v1\",\n      \"headers\": {\n        \"X-API-KEY\": \"${env:ORBITYPE_SQL_API_KEY_PROD}\"\n      }\n    }\n  }\n}

Lege je nach Bedarf separate Einträge für SQL/S3/public/private Keys an.

https://developers.openai.com/apps-sdk/deploy/connect-chatgpt