API VEGA

PicSee MCP Server

Официальный удалённый сервер Model Context Protocol (MCP) для PicSee, PicSee, сервиса по сокращению URL с управлением ссылками и аналитикой кликов.

Подключайте AI‑агента к PicSee, чтобы создавать короткие ссылки, управлять существующими и анализировать показатели кликов с помощью естественного языка.

Official MCP endpoint

https://api.picsee.io/mcp

  • Транспорт: Streamable HTTP

  • Аутентификация: Anonymous или OAuth 2.1 с PKCE

  • Имя реестра: io.picsee/short-link

  • Официальный реестр: MCP Registry

Возможности

Анонимный доступ

Анонимные клиенты могут создавать короткую ссылку PicSee с использованием общего домена pse.is. Анонимный доступ не раскрывает данные учётной записи, списки ссылок, инструменты управления или аналитику.

Доступ после входа в учетную запись

После входа через PicSee OAuth доступные инструменты зависят от плана API вашей учётной записи:

  • Создание коротких ссылок с использованием доступных доменов PicSee или брендированных доменов.

  • Проверка статуса и использования API-плана.

  • Перечень доступных доменов, тегов и инструментов отслеживания.

  • Перечень, удаление или восстановление коротких ссылок.

  • Просмотр обзора, ежедневных кликов, устройств, источников переходов и аналитики по странам.

  • Используйте редактирование по Advanced‑плану, поиск, метаданные, отслеживание и пометки аудитории, если они доступны.

Сервер динамически предоставляет только те инструменты, которые поддерживает вошедший в систему аккаунт.

Установка

Codex

codex mcp add picsee --url https://api.picsee.io/mcp

Перезапустите Codex после установки. Чтобы войти для управления аккаунтом и аналитикой:

codex mcp login picsee

Claude Desktop или другой MCP‑клиент

Добавьте следующий Streamable HTTP‑сервер в конфигурацию MCP клиента:

{
  "mcpServers": {
    "picsee": {
      "url": "https://api.picsee.io/mcp"
    }
  }
}

Если клиент не поддерживает удалённый Streamable HTTP напрямую, используйте MCP удалённый мост, поддерживаемый этим клиентом.

Примеры запросов

Shorten https://picsee.io and attribute the API usage to Codex.

Show my 10 most recent PicSee short links.

Show daily clicks and referrer sources for short link abc123 over the last 30 days.

Change the destination of abc123 to https://example.com/new-page.

Редактирование доступно только при наличии соответствующего плана API PicSee.

Аутентификация

PicSee использует поток авторизации по OAuth 2.1 с кодовым подтверждением (authorization code) и PKCE, а также динамическую регистрацию клиента.

  • Authorization server: https://public-api-oauth.picsee.io

  • Protected resource: https://api.picsee.io/mcp

  • Scopes: user:read, user:write

Клиент MCP хранит access и refresh tokens. Настоящее репозиторию не запрашивает у пользователей ввод API‑токенов в подсказках или конфигурационных файлах.

Почему запрашиваются эти области доступа

  • user:read: чтение статуса API‑аккаунта, доменов, тегов, списка коротких ссылок и аналитики.

  • user:write: создание, редактирование, удаление и восстановление коротких ссылок при наличии соответствующего плана аккаунта.

Доступность инструментов

Уровень доступаДоступные инструменты
Анонимныйcreate_short_link
Авторизованный пользовательcreate_short_link, get_api_status, get_api_usage_by_external_id, get_my_domains, get_my_tags, get_my_tracking_tools, list_short_links, delete_short_link, get_link_overview, get_link_daily_clicks, get_link_platforms, get_link_referrers, get_link_regions
Расширенный планКроме инструментов для авторизованных пользователей — edit_short_link и get_link_audience_labels; включены и расширенные поля и фильтры поиска

Доступность инструментов определяется во время подключения. Используйте инструмент‑инспектор вашего MCP‑клиента или tools/list, чтобы увидеть конкретные инструменты, доступные для текущей учётной записи.

Конфиденциальность и безопасность

  • Никогда не передавайте токены доступа PicSee в подсказках,issues, скриншотах или журналах.

  • Перед созданием или редактированием короткой ссылки проверьте целевой URL.

  • Аналитика может содержать приватную информацию о кампаниях и аудитории; передавайте её только предназначенным получателям.

  • Разрешения OAuth можно отозвать в вашей учётной записи PicSee.

См. Политика конфиденциальности PicSee и Условия использования.

Документация и поддержка

При сообщении об ошибке укажите имя MCP‑клиента, выполняемую операцию, временную метку и санитированное сообщение об ошибке. Не включайте токены доступа или приватные данные аналитики.

Разработка

Требования:

  • Node.js 22 и выше

  • pnpm

pnpm install
pnpm check
pnpm dev

Перед выпуском убедитесь, что версии в package.json, server.json и ответе MCP initialize идентичны.

Лицензия

MIT © PicSee Inc.