@paragraph-com/mcp

MCP-сервер (Model Context Protocol) для Paragraph — откройте доступ к вашей публикации для ИИ-агентов в Claude Desktop, Cursor, VS Code Copilot и любом MCP-совместимом клиенте.

Удалённый сервер (рекомендуется)

Используйте размещённый сервер по адресу mcp.paragraph.com — установка и управление API-ключами не требуются. Вы пройдёте аутентификацию через свою учётную запись Paragraph в браузере.

Claude Code

claude mcp add paragraph --transport http https://mcp.paragraph.com/mcp

Claude Desktop

Добавьте в claude_desktop_config.json:

{
  "mcpServers": {
    "paragraph": {
      "url": "https://mcp.paragraph.com/mcp"
    }
  }
}

Cursor

Добавьте в .cursor/mcp.json:

{
  "mcpServers": {
    "paragraph": {
      "url": "https://mcp.paragraph.com/mcp"
    }
  }
}

VS Code

Добавьте в .vscode/mcp.json:

{
  "servers": {
    "paragraph": {
      "url": "https://mcp.paragraph.com/mcp"
    }
  }
}

Related MCP server: thegraph-mcp

Локальный сервер

Если вы предпочитаете запускать сервер локально, можно использовать npx. Требуется Node.js 18+.

npx @paragraph-com/mcp

Аутентификация (только для локального режима)

Удалённый сервер автоматически обрабатывает аутентификацию. Для локального использования задайте свой API-ключ через переменную окружения:

PARAGRAPH_API_KEY=your-key npx @paragraph-com/mcp

Или войдите с помощью Paragraph CLI — MCP-сервер использует ту же конфигурацию:

npx @paragraph-com/cli login
npx @paragraph-com/mcp

Локальная настройка по клиентам

claude mcp add paragraph -- npx @paragraph-com/mcp

Добавьте в claude_desktop_config.json:

{
  "mcpServers": {
    "paragraph": {
      "command": "npx",
      "args": ["@paragraph-com/mcp"],
      "env": {
        "PARAGRAPH_API_KEY": "your-key"
      }
    }
  }
}

Добавьте в .cursor/mcp.json или .vscode/mcp.json:

{
  "servers": {
    "paragraph": {
      "command": "npx",
      "args": ["@paragraph-com/mcp"],
      "env": {
        "PARAGRAPH_API_KEY": "your-key"
      }
    }
  }
}

Streamable HTTP (локальный режим)

npx @paragraph-com/mcp --http --port 3100

HTTP-режим привязывается к 127.0.0.1 (только localhost) и принимает POST-запросы. Проверка работоспособности доступна по адресу GET /health.

Доступные инструменты

Записи

• get-post — Получить запись по ID или slug

• list-posts — Список записей из публикации или ваших собственных записей

• create-post — Создать новую запись (markdown)

• update-post — Обновить существующую запись

• delete-post — Удалить запись

• send-test-email — Отправить тестовый выпуск рассылки для черновика

Контент

Черновики короткоформатного контента — посты и треды в X, посты в LinkedIn, разовые письма и статьи в X. Эти инструменты только создают черновик; автор отправляет материал из приложения Paragraph.

• create-content — Сохранить материал в библиотеку вашей публикации

• list-content — Показать вашу библиотеку с фильтрацией по типу и статусу

• get-content — Получить один материал вместе с его содержимым

• update-content — Переименовать материал или заменить его содержимое

• archive-content — Отложить материал в архив без удаления

• restore-content — Вернуть материал из архива

Публикации

• get-publication — Получить метаданные публикации по ID, slug или домену

Подписчики

• list-subscribers — Список ваших подписчиков

• get-subscriber-count — Получить количество подписчиков

• add-subscriber — Добавить подписчика по email или кошельку

Пользователи

• get-user — Получить профиль пользователя по ID или кошельку

Монеты

• get-coin — Получить метаданные монеты или список популярных монет

• list-coin-holders — Получить держателей монеты

Поиск

• search-posts — Поиск записей

• search-blogs — Поиск публикаций

• search-coins — Поиск монет

Лента

• get-feed — Получить курируемую ленту платформы

Профиль

• get-me — Получить информацию о вашей аутентифицированной публикации

Аналитика

• analytics-query — Выполнить SQL-запрос только для чтения к аналитике вашей публикации (показатель открытий, CTR, количество подписчиков, лучшие записи и т. д.)

• analytics-schema — Список доступных таблиц и колонок в схеме аналитики

Фильтрация наборов инструментов

Открывайте доступ только к тем инструментам, которые нужны вашему агенту:

npx @paragraph-com/mcp --toolsets posts,search

Доступные наборы инструментов: posts, content, publications, subscribers, users, coins, search, feed, me, analytics, emails

Примеры

Поиск и обобщение записей по теме

Промпт: «Найди записи об ончейн-управлении и дай сводку лучших результатов»

MCP-сервер вызывает search-posts с этим запросом. Claude получает подходящие записи и составляет сводку ключевых тем, авторов и публикаций.

Создание черновика и публикация записи в блоге

Промпт: «Напиши запись под названием "Weekly Update #12" о нашей новой функции токен-гейтинга, затем опубликуй её»

Сервер вызывает create-post с заголовком и сгенерированным markdown-содержимым, создавая черновик. После вашего подтверждения он вызывает update-post, чтобы установить статус published, и запись становится доступной в вашей публикации.

Получение аналитики по подписчикам

Промпт: «Сколько подписчиков у моей публикации? Покажи самых новых»

Сервер вызывает get-me, чтобы определить вашу публикацию, затем get-subscriber-count для получения общего количества и list-subscribers, чтобы вернуть последних подписчиков с их данными.

Ответы на вопросы об эффективности рассылки

Промпт: «Какой у меня средний показатель открытий за последние 30 дней и какие записи показали лучшие результаты?»

Сервер вызывает analytics-query с ограниченным SQL-запросом к post_analytics_summary, возвращая показатели открытий, CTR и просмотры для каждой записи. Claude обобщает тенденцию и выделяет лучшие результаты.

Просмотр ленты платформы

Промпт: «Что сейчас популярно на Paragraph?»

Сервер вызывает get-feed, чтобы получить курируемую ленту платформы, а Claude обобщает лучшие записи, их авторов и темы.

Управление жизненным циклом записей

Промпт: «Покажи мои черновики и отправь тестовое письмо для самого последнего»

Сервер вызывает list-posts с параметром status: draft, чтобы получить ваши черновики, затем send-test-email с ID последнего черновика, чтобы вы могли просмотреть выпуск рассылки во входящих перед отправкой подписчикам.

Поддержка

• Проблемы и ошибки: GitHub Issues

• Электронная почта: support@paragraph.com

• Веб-сайт: paragraph.com

Релизы

npm run release patch   # 1.0.0 → 1.0.1
npm run release minor   # 1.0.0 → 1.1.0
npm run release major   # 1.0.0 → 2.0.0

Собирает проект, запускает тесты, публикует пакет в npm, развёртывает Cloudflare Worker на mcp.paragraph.com и создаёт релиз на GitHub. Скрипт запросит недостающие учётные данные.

Политика конфиденциальности

Этот MCP-сервер подключается к API Paragraph от вашего имени. Подробнее о сборе, использовании, хранении данных и ваших правах см. в Политике конфиденциальности Paragraph.

Лицензия

MIT