Связать Picasi с Claude Code

О чем идет речь

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

Что вам понадобится

Токен API Picasi (инструкция: Создать токен API)
URL-адрес MCP (его можно найти в разделе «Настройки» → «Подключения к ИИ и токены»)

Вариант A: Настройка через CLI

Подготовь токен и URL-адрес

Открой Настройки → Подключения к ИИ и токены в Picasi и скопируйте URL-адрес MCP. Он выглядит как https://picasi.app/mcp и одинаков для всех Workspaces: какой из них показывает сервер, решает токен.
Добавление сервера MCP

Выполни следующую команду в терминале:
Окно терминала
```
claude mcp add picasi \
  --transport http \
  --url https://picasi.app/mcp \
  --header "Authorization: Bearer DEIN_TOKEN"
```
Замени DEIN_TOKEN на свой токен.
Проверка подключения

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

Какие источники есть в моей Workspace Picasi?

Если подключение работает, Claude ответит реальными данными.

Вариант B: непосредственное редактирование файла `.mcp.json`

Если вы предпочитаете хранить конфигурацию в виде файла в проекте:

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

Сохраните этот файл под именем .mcp.json в корневом каталоге вашего проекта. Claude Code прочитает его автоматически.

Переменные окружения вместо открытого текста

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

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

Вместо создания .mcp.json для каждого проекта отдельно, создайте сервер один раз на глобальном уровне:

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

Тогда сервер будет доступен во всех проектах без необходимости .mcp.json в репозитории.

2. Переменная среды в файле, не подлежащем фиксации

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

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

Установите переменную PICASI_API_TOKEN в файле .env (в .gitignore) или непосредственно в оболочке, в которой запускается Claude Code:

export PICASI_API_TOKEN=picasi_pat_xxxxxxxxxx
claude

Claude Code считывает эту переменную только при запуске. Если токен изменяется, необходимо перезапустить Claude Code.

Несколько Workspaces

При наличии нескольких Workspaces Picasi (например, агентство с несколькими клиентами) создайте для каждого Workspace отдельную запись сервера и присвойте ей однозначное имя:

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

Адрес в обеих записях одинаков, Workspace заложен в токене. Claude Code запускает инструменты серверов в отдельных пространствах имён (picasi-kunde-a:list_sources, picasi-kunde-b:list_sources), чтобы избежать путаницы.

Старый адрес с кодом Workspace

В старых конфигурациях стоит адрес вида https://picasi.app/mcp/t-xxxxxxxxxx, с кодом Workspace в конце. Он работает без изменений, перестраивать ничего не нужно. Для новых записей используйте https://picasi.app/mcp.

Дополнительные темы

Инструменты MCP — обзор Все доступные инструменты MCP с параметрами.