Связать Picasi с Claude Code

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

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

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

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

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

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

Откройте Настройки → Подключения к ИИ и токены в Picasi и скопируйте URL-адрес MCP (формат: https://picasi.app/mcp/t-xxxxxxxxxx).
Добавление сервера MCP

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

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

> Какие источники есть в моей рабочей области Picasi?

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

Вариант B: непосредственное редактирование файла `.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 для каждого проекта отдельно, создайте сервер один раз на глобальном уровне:

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:

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 — обзор Все доступные инструменты MCP с параметрами.