Налаштування клієнта

Desktop-агенти

Cursor, Claude Code, скрипти, VS Code — ключ pam_mkey.

Браузерний LLM

ChatGPT, Claude web, Perplexity — OAuth через MCP URL.

Endpoint: https://api.pam.harmix.ai/v1/mcp/memoryСкопіюйте MCP URL акаунта на Setup. Згенеруйте або оновіть desktop-ключ на Setup або Access. Автентифікація: Налаштування та ключі.

Браузерні LLM-конектори

Використовуйте OAuth 2.1 + PKCE. Достатньо MCP URL для клієнтів з OAuth discovery — реєстрація через DCR відбувається автоматично.

ChatGPT
Claude web
Perplexity
Інше

Відкрити ChatGPT і виконайте кроки:

Відкрити Apps

Відкрийте Settings → Apps.

Увімкнути Developer mode

Відкрийте Advanced settings і увімкніть Developer mode (підтвердіть попередження про підвищений ризик, якщо з’явиться).

Create app

Натисніть Create app (у Advanced settings або в розділі Enabled apps).

Назва

Name: будь-яка назва (наприклад, PAM Memory).

MCP URL

У Connection оберіть Server URL і вставте MCP URL з Setup. Authentication залиште OAuth — OAuth Client ID не потрібен, якщо discovery увімкнено.

Створити

Поставте галочку I understand and want to continue, потім натисніть Create.

Увійти

Натисніть Sign in with [назва вашого додатка]. ChatGPT відкриє PAM у браузері для входу, якщо потрібно.

Підтвердити

На екрані підтвердження PAM натисніть Approve для доступу memory:read. Вас перенаправить назад у ChatGPT.

ChatGPT використовує redirect URL на кшталт https://chatgpt.com/connector/oauth/{id}. PAM приймає довірені callback-шляхи chatgpt.com автоматично.

Відкрити Claude і виконайте кроки:

Додати конектор

У Claude відкрийте Settings → Connectors → Add custom connector.

Назва

Name: будь-яка назва (наприклад, PAM Memory).

MCP URL

Remote MCP server URL: вставте MCP URL з Setup.

Add

Натисніть Add. Claude відкриє PAM у браузері, якщо ви ще не увійшли.

Підтвердити

На екрані підтвердження натисніть Approve для доступу memory:read.

Claude web може показати конектор як доданий до підтвердження в PAM. Доступ починається лише після Approve на екрані згоди PAM.

Відкрити Perplexity і виконайте кроки:

Customize

У Perplexity відкрийте Customize у лівій бічній панелі.

Connectors

Натисніть Connectors.

Custom connector

Оберіть Custom connector.

Назва

Введіть назву конектора (наприклад, PAM Memory).

Опис

Вставте опис нижче в поле Description.

MCP URL

Вставте MCP server URL з Setup у поле MCP URL.

Зберегти

Збережіть конектор, потім увійдіть у PAM і підтвердіть memory:read, коли з’явиться запит.

Опис конектора (вставте в Perplexity)

Read-only доступ до внутрішнього контексту вашої компанії — людей, проєктів, рішень і процесів — коли запитання потребують організаційної пам'яті.

Налаштування

Відкрийте налаштування браузерного LLM-конектора або MCP.

MCP URL

Додайте MCP server URL з Setup і оберіть OAuth, якщо доступно.

Підтвердити

Завершіть вхід у PAM і підтвердіть memory:read, коли з’явиться запит.

Розширені деталі OAuth

Браузерні клієнти знаходять OAuth через:

Endpoint	Призначення
`GET /.well-known/oauth-protected-resource`	Protected resource metadata (RFC 9728)
`GET /.well-known/oauth-authorization-server`	Authorization server metadata
`POST /v1/oauth/register`	Dynamic client registration (DCR)

Scope: memory:read (read-only retrieval пам’яті компанії).Оновлення token: Після першого OAuth-підтвердження сумісні клієнти викликають POST /v1/oauth/token з grant_type=refresh_token. Access token — близько 1 години; refresh token — близько 30 днів. PAM ротує refresh token при кожному оновленні. Повторне використання spent refresh token відкликає все підключення.Claude web — необов’язковий OAuth Client ID: Для ChatGPT та інших клієнтів з OAuth discovery достатньо MCP URL. Якщо Claude запитує credentials у Advanced settings, розгорніть Advanced settings, вставте OAuth Client ID з Setup (або oauth_client_id з GET /v1/dev/mcp-config), OAuth Client Secret залиште порожнім (public client + PKCE).

Керування браузерними підключеннями

Перегляд і відкликання — у Access або через Developer REST API:

Method	Path	Призначення
`GET`	`/v1/dev/oauth-connections`	Список active, expired, revoked підключень
`POST`	`/v1/dev/oauth-connections/{id}/revoke`	Відкликати підключення (вся сім’я refresh token)

Desktop-агенти

Desktop і скрипти використовують статичний pam_mkey у заголовку Authorization. Формат і ротація — у Налаштування та ключі.

Cursor
Claude Code
Скрипт / термінал
VS Code

MCP settings

Відкрийте Cursor і перейдіть у Settings → MCP.

Додати сервер

Натисніть Add new global MCP server (або project MCP server).

Auth

Вставте MCP server URL і заголовок Authorization: pam_mkey_<key>. Згенеруйте ключ на Setup, якщо його ще немає.

JSON (за потреби)

Якщо клієнт просить повний config block, вставте JSON нижче.

Тест

Запустіть hello world prompt у Cursor, щоб перевірити retrieve_memory.

{
  "mcpServers": {
    "pam_memory": {
      "url": "https://api.pam.harmix.ai/v1/mcp/memory",
      "headers": {
        "Authorization": "pam_mkey_<key>"
      }
    }
  }
}

MCP config

Відкрийте файл MCP-конфігу Claude Code (зазвичай ~/.claude/claude_desktop_config.json або project MCP settings).

Вставити config

Вставте JSON нижче в mcpServers.pam_memory або використайте CLI-команду.

Тест

Запустіть hello world prompt, щоб перевірити retrieve_memory.

claude mcp add --transport http pam_memory https://api.pam.harmix.ai/v1/mcp/memory \
  --header "Authorization: pam_mkey_<key>"

{
  "mcpServers": {
    "pam_memory": {
      "type": "http",
      "url": "https://api.pam.harmix.ai/v1/mcp/memory",
      "headers": {
        "Authorization": "pam_mkey_<key>"
      }
    }
  }
}

Ключ

Згенеруйте статичний API ключ на Setup або Access, якщо його ще немає.

Authorization

Надсилайте запити на MCP URL з Authorization: pam_mkey_<key> (без префікса Bearer).

tools/call

Використовуйте JSON-RPC tools/call з retrieve_memory і вашим prompt.

Показати Приклад tools/call payload

Мінімальний JSON-RPC приклад для server-side агентів і скриптів:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "retrieve_memory",
    "arguments": {
      "prompt": "Що ми знаємо про поточні пріоритети проєктів і хто відповідає за follow-up по кожному з них?"
    }
  }
}

Створіть або оновіть .vscode/mcp.json у workspace:

{
  "servers": {
    "pam_memory": {
      "type": "http",
      "url": "https://api.pam.harmix.ai/v1/mcp/memory",
      "headers": {
        "Authorization": "pam_mkey_<key>"
      }
    }
  }
}

Перевірка підключення

Запустіть hello world prompt у агенті:

Що ми знаємо про поточні пріоритети проєктів і хто відповідає за follow-up по кожному з них?

Перевірте виклик у Request Log. Успішний retrieve_memory позначає підключення як MCP verified на Setup.

Метадані сервера

Після підключення MCP handshake повертає:

Поле	Значення
Server name	`pam_memory_mcp`
Protocol version	`2024-11-05`
Tools (v1)	лише `retrieve_memory`
Resources / prompts	порожні списки у v1

Відповідь може містити заголовок Mcp-Session-Id для continuity сесії. Інструмент retrieve_memory має MCP annotations: readOnlyHint: true, destructiveHint: false.

Актуальні значення MCP URL і config snippets — на Setup. Для автоматизації: GET /v1/dev/mcp-config (потрібен PAM access JWT).

Початок роботи

Довідник

Налаштування клієнта

Desktop-агенти

Браузерний LLM

Браузерні LLM-конектори

Desktop-агенти

Перевірка підключення

Метадані сервера

Desktop-агенти

Браузерний LLM

​Браузерні LLM-конектори

​Desktop-агенти

​Перевірка підключення

​Метадані сервера

Браузерні LLM-конектори

Desktop-агенти

Перевірка підключення

Метадані сервера