Model Context Protocol (MCP)

1 a. Автентифікація — API-токен (рекомендовано для продуктивного середовища)

Для постійного з’єднання з AI використовуйте довгостроковий API-токен. Токен повинен бути згенерований адміністратором (учасником ролі pgarachne_admin):

-- Switch to the administrator role
SET ROLE pgarachne_admin;

-- Generate a new token for the target role (e.g., 'app_user')
SELECT pgarachne.add_api_token('Claude Desktop', 'app_user');

Збережіть повернутий рядок. Використовуйте його як Authorization: Bearer YOUR_API_TOKEN у конфігурації AI-клієнта.

1 b. Автентифікація — прямі облікові дані (розробка та прості налаштування)

Альтернативно, надсилайте ім’я користувача PostgreSQL та пароль безпосередньо за допомогою HTTP Basic Authentication. Керування API-токенами не потрібне, і команда GRANT … TO pgarachne не потрібна — PgArachne підключається безпосередньо як зазначений користувач.

Authorization: Basic <base64(username:password)>

Використовуйте цей підхід для локального тестування або внутрішніх інструментів, де облікові дані вже безпечно керуються. Для продуктивних інтеграцій AI з хмарними клієнтами API-токени є більш прийнятним варіантом.

2. Claude Desktop

Додайте PgArachne до конфігурації Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):

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

Примітка: для з’єднання обов’язковий HTTP(S). У прикладі використовується npx-мостик server-http від Anthropic, який діє як посередник між стандартним MCP (stdio) та PgArachne (HTTP).

3. Cursor

У налаштуваннях Cursor (Settings > MCP) додайте новий сервер, що зв’язується безпосередньо через HTTP (або за допомогою згаданого вище мостика, якщо ваша версія Cursor не підтримує нативні HTTP MCP-сервери):

• Type: command (з npx-мостиком) або http
• Name: PgArachne
• URL: https://your-api.com/db/my_database/mcp
• Auth Header: Authorization: Bearer YOUR_API_TOKEN