Перейти до вмісту
Picasi Picasi Документація Picasi
До застосунку

Підключити Picasi до Claude Code

Про що йдеться

Ви налаштовуєте Picasi як сервер MCP у Claude Code. Після цього ви можете безпосередньо в чаті Claude запитувати про оновлення ваших конкурентів, керувати джерелами або переглядати звіти — без необхідності відкривати додаток Picasi.

Що вам знадобиться

  • Токен API Picasi (інструкція: Створити токен API)
  • URL-адресу MCP вашого робочого простору (її можна знайти в розділі Налаштування → З’єднання з ШІ та токени)

Варіант А: Налаштування за допомогою CLI

  1. Підготуйте токен та URL-адресу

    Відкрийте Налаштування → З’єднання з ШІ та токени у Picasi та скопіюйте URL-адресу MCP (формат: https://picasi.app/mcp/t-xxxxxxxxxx).

  2. Додайте сервер MCP

    Виконайте наступну команду в терміналі:

    Terminal window
    claude mcp add picasi \
      --transport http \
      --url https://picasi.app/mcp/t-xxxxxxxxxx \
      --header "Authorization: Bearer DEIN_TOKEN"

    Замініть t-xxxxxxxxxx та DEIN_TOKEN на ваші фактичні значення.

  3. Перевірка з’єднання

    Запустіть Claude Code та введіть:

    > Які джерела є в моєму робочому просторі Picasi?

    Якщо з’єднання працює, Claude відповість реальними даними.

Варіант Б: безпосередньо редагувати .mcp.json

Якщо ви бажаєте зберігати конфігурацію у вигляді файлу в проєкті:

{
  "mcpServers": {
    "picasi": {
      "type": "http",
      "url": "https://picasi.app/mcp/t-xxxxxxxxxx",
      "headers": {
        "Authorization": "Bearer DEIN_TOKEN"
      }
    }
  }
}

Збережіть цей файл під назвою .mcp.json у кореневому каталозі вашого проєкту. Claude Code автоматично його прочитає.

Змінні середовища замість відкритого тексту

Для проєктів, чий файл .mcp.json знаходиться в Git, ніколи не вказуйте токен у вигляді відкритого тексту. Два безпечні способи:

1. Глобальна конфігурація Claude Code

Замість .mcp.json для конкретного проєкту створіть сервер один раз на глобальному рівні:

Terminal window
claude mcp add picasi \
  --scope user \
  --transport http \
  --url https://picasi.app/mcp/t-xxxxxxxxxx \
  --header "Authorization: Bearer DEIN_TOKEN"

Тоді сервер буде доступний у всіх проєктах без .mcp.json у репозиторії.

2. Змінна середовища в файлі, що не підлягає комітуванню

Для серверів, специфічних для проекту: зафіксуйте .mcp.json у репозиторії, але зчитуйте токен із середовища.

{
  "mcpServers": {
    "picasi": {
      "type": "http",
      "url": "https://picasi.app/mcp/t-xxxxxxxxxx",
      "headers": {
        "Authorization": "Bearer ${env:PICASI_API_TOKEN}"
      }
    }
  }
}

Встановити змінну PICASI_API_TOKEN у файлі .env (у .gitignore) або безпосередньо в оболонці, в якій запускається Claude Code:

Terminal window
export PICASI_API_TOKEN=picasi_pat_xxxxxxxxxx
claude

Claude Code зчитує змінну лише під час запуску. Якщо токен змінено, Claude Code потрібно перезапустити.

Кілька робочих просторів

У разі наявності кількох робочих просторів Picasi (наприклад, агентство з кількома клієнтами) для кожного робочого простору створіть окремий запис сервера та надайте йому унікальну назву:

{
  "mcpServers": {
    "picasi-kunde-a": {
      "type": "http",
      "url": "https://picasi.app/mcp/t-aaaaaaa",
      "headers": { "Authorization": "Bearer ${env:PICASI_TOKEN_KUNDE_A}" }
    },
    "picasi-kunde-b": {
      "type": "http",
      "url": "https://picasi.app/mcp/t-bbbbbbb",
      "headers": { "Authorization": "Bearer ${env:PICASI_TOKEN_KUNDE_B}" }
    }
  }
}

Claude Code запускає інструменти серверів у окремих просторах імен (picasi-kunde-a:list_sources, picasi-kunde-b:list_sources), щоб уникнути плутанини.

Додаткові теми

MCP-Tools — огляд Усі доступні інструменти MCP із параметрами.