Model Context Protocol (MCP)

1 a. Authentifizierung — API-Token (empfohlen für Produktion)

Für eine dauerhafte KI-Verbindung verwenden Sie ein langlebiges API-Token. Das Token muss von einem Administrator (einem Mitglied der Rolle pgarachne_admin) generiert werden:

-- Zur Administrator-Rolle wechseln
SET ROLE pgarachne_admin;

-- Neues Token für die Zielrolle generieren (z. B. 'app_user')
SELECT pgarachne.add_api_token('Claude Desktop', 'app_user');

Speichern Sie den zurückgegebenen Wert. Verwenden Sie ihn als Authorization: Bearer IHR_API_TOKEN in der Konfiguration des KI-Clients.

1 b. Authentifizierung — Direkte Zugangsdaten (Entwicklung & einfache Setups)

Alternativ können Sie PostgreSQL-Benutzername und Passwort direkt über HTTP Basic Authentication übermitteln. Es ist kein Token-Management erforderlich und kein GRANT … TO pgarachne notwendig — PgArachne verbindet sich direkt als der angegebene Benutzer.

Authorization: Basic <base64(benutzername:passwort)>

Verwenden Sie diesen Ansatz für lokale Tests oder interne Dienste, bei denen Zugangsdaten bereits sicher verwaltet werden. Für produktive KI-Integrationen mit Cloud-Clients sind API-Token die bevorzugte Wahl.

2. Claude Desktop

Fügen Sie PgArachne zu Ihrer Claude Desktop-Konfiguration hinzu (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "pgarachne": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-http",
        "--url",
        "https://ihre-api.com/db/my_database/mcp"
      ],
      "env": {
        "Authorization": "Bearer IHR_API_TOKEN"
      }
    }
  }
}

Hinweis: HTTP(S) ist erforderlich für die Verbindung. Das Beispiel verwendet die server-http-npx-Bridge von Anthropic, die als Vermittler zwischen Standard-MCP (stdio) und PgArachne (HTTP) fungiert.

3. Cursor

Fügen Sie in den Cursor-Einstellungen (Einstellungen > MCP) einen neuen Server hinzu, der direkt über HTTP kommuniziert (oder verwenden Sie die oben genannte Bridge, falls Ihre Cursor-Version keine nativen HTTP-MCP-Server unterstützt):

• Typ: command (mit npx-Bridge) oder http
• Name: PgArachne
• URL: https://ihre-api.com/db/my_database/mcp
• Auth-Header: Authorization: Bearer IHR_API_TOKEN