MCP: подключение и работа через бота

Инструкция для обычного пользователя: как подключить MCP-сервер к Codex/Claude Code и управлять Serparium через AI-бота.

MCP: setup and bot workflow

User guide for connecting MCP server to Codex/Claude Code and operating Serparium via AI bot.

Для обычного пользователя (без admin)

  1. Подготовьте логин/пароль от биржи.
  2. Скачайте MCP-файл: link-manager-mcp-server.mjs.
  3. Используйте путь к скачанному файлу (например: /Users/you/Downloads/link-manager-mcp-server.mjs).
  4. Используйте боевой URL: https://serparium.com.

Подключение в Claude Code

claude mcp add link-manager --scope user \
  -e LM_API_BASE_URL=https://serparium.com \
  -e LM_API_USERNAME=your_user \
  -e LM_API_PASSWORD=your_password \
  -e LM_MCP_ENFORCE_NON_ADMIN=true \
  -e LM_MCP_ENABLE_ADMIN_TOOLS=false \
  -- node "/ABS/PATH/TO/link-manager-mcp-server.mjs"

Подключение в Codex (~/.codex/config.toml)

[mcp_servers.link_manager]
command = "node"
args = ["/ABS/PATH/TO/link-manager-mcp-server.mjs"]

[mcp_servers.link_manager.env]
LM_API_BASE_URL = "https://serparium.com"
LM_API_USERNAME = "your_user"
LM_API_PASSWORD = "your_password"
LM_MCP_ENFORCE_NON_ADMIN = "true"
LM_MCP_ENABLE_ADMIN_TOOLS = "false"

Проверка после подключения

Вызовите tool link_manager_mcp_status. Если статус успешный, можно работать через tools для проектов, ссылок, статей и размещений.

MCP Limited, MCP Full и API доступ

Да, доступно два режима автоматизации: прямой API (token/session) и MCP-сервер в Codex/Claude Code. MCP работает поверх того же backend API, но через tools-интерфейс бота.

Можно ли “скормить” инструкцию боту?

Да. Дайте боту этот шаблон задачи:

Подключи MCP сервер link-manager.

1) Добавь MCP в Claude Code (или Codex) с параметрами:
- LM_API_BASE_URL=https://serparium.com
- LM_API_USERNAME=<мой логин>
- LM_API_PASSWORD=<мой пароль>
- LM_MCP_ENFORCE_NON_ADMIN=true
- LM_MCP_ENABLE_ADMIN_TOOLS=false

2) Проверь подключение tool-ом link_manager_mcp_status.
3) После проверки создай проект, добавь ссылки/статьи и покажи результат.

Отложенная публикация: правило распределения дат

  1. При отложенной публикации распределяйте даты по периоду, а не ставьте одну дату всем размещениям.
  2. Если задано N размещений на N дней, ставьте по 1 размещению на каждый день.
  3. Пример: 10 ссылок на 10 дней = даты day+1 ... day+10 (10 разных дней).

Короткая команда для бота

Для отложенной публикации распредели даты равномерно по дням.
Не назначай одну и ту же дату всем размещениям.
Если 10 ссылок на 10 дней — поставь 1 ссылку на каждый день.

Генерация анкоров через MCP

Для анкоров используйте входной формат: URL - нужный анкор. Боту передавайте правила без изменений:

  1. Окружающий текст должен быть слева и справа от анкора.
  2. Минимальная длина одного результата: 150 символов.
  3. Разнообразить контекст и вписывать анкоры по смыслу.
  4. Не менять текст внутри анкора.
  5. Писать сухо, без прилагательных.
  6. Использовать контекст казино.
  7. Минимум 2 предложения в одном результате.
  8. Не использовать бренды в окружающем тексте, писать нейтрально.
  9. Не раскрывать приватные домены в инструкции и примерах (использовать плейсхолдеры).

Готовый шаблон для бота

Составь анкоры по списку в формате: URL - анкор.

Правила:
1) Окружающий текст должен быть слева и справа от анкора.
2) Минимальная длина каждого результата 150 символов.
3) Разнообразь анкоры и вписывай их в контекст корректно.
4) Не меняй текст внутри анкоров.
5) Пиши сухо и без прилагательных.
6) Используй в окружающем тексте контекст казино.
7) Минимум 2 предложения в одном результате.
8) Окружающий текст делай нейтральным, без брендов.
9) Не раскрывай приватные URL в пояснениях и примерах.

Формат выхода:
- Только список результатов.
- Без дополнительных пояснений.
- Каждый результат в одну строку (без переносов внутри результата).

Генерация статей из вашего промпта

Используйте tool link_manager_generate_and_create_project_articles. Он использует ваш prompt как основной источник требований и не навязывает жёсткий шаблон.

Для генерации укажите в env: LM_OPENAI_API_KEY (или OPENAI_API_KEY).

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

{
  "project_id": 1248,
  "prompt": "Нужно написать статью рерайт ... (вставьте ваш полный промпт)",
  "source_html": "<h1>...</h1><p>...</p>",
  "count": 3
}

Regular user setup (non-admin)

  1. Prepare your exchange username/password.
  2. Download MCP script: link-manager-mcp-server.mjs.
  3. Use local path to downloaded file (example: /Users/you/Downloads/link-manager-mcp-server.mjs).
  4. Use production URL: https://serparium.com.

Claude Code setup

claude mcp add link-manager --scope user \
  -e LM_API_BASE_URL=https://serparium.com \
  -e LM_API_USERNAME=your_user \
  -e LM_API_PASSWORD=your_password \
  -e LM_MCP_ENFORCE_NON_ADMIN=true \
  -e LM_MCP_ENABLE_ADMIN_TOOLS=false \
  -- node "/ABS/PATH/TO/link-manager-mcp-server.mjs"

Codex setup (~/.codex/config.toml)

[mcp_servers.link_manager]
command = "node"
args = ["/ABS/PATH/TO/link-manager-mcp-server.mjs"]

[mcp_servers.link_manager.env]
LM_API_BASE_URL = "https://serparium.com"
LM_API_USERNAME = "your_user"
LM_API_PASSWORD = "your_password"
LM_MCP_ENFORCE_NON_ADMIN = "true"
LM_MCP_ENABLE_ADMIN_TOOLS = "false"

Post-setup check

Run link_manager_mcp_status. If successful, use MCP tools for projects, links, articles, and placements.

MCP Limited, MCP Full, and API Access

Yes, there are two automation modes: direct API (token/session) and MCP server in Codex/Claude Code. MCP is a bot-friendly tools layer on top of the same backend API.

Can I pass this to my bot?

Yes. Use this prompt template:

Connect MCP server "link-manager".

1) Configure Claude Code (or Codex) with:
- LM_API_BASE_URL=https://serparium.com
- LM_API_USERNAME=<my user>
- LM_API_PASSWORD=<my password>
- LM_MCP_ENFORCE_NON_ADMIN=true
- LM_MCP_ENABLE_ADMIN_TOOLS=false

2) Verify with tool link_manager_mcp_status.
3) After verification, create project, add links/articles, and report results.

Delayed publishing: date distribution rule

  1. For delayed publishing, distribute dates across the period instead of assigning one date to all placements.
  2. If request is N placements over N days, schedule one placement per day.
  3. Example: 10 links over 10 days = day+1 ... day+10 (10 distinct days).

Short bot instruction

For delayed publishing, distribute publish dates evenly by day.
Do not assign the same date to all placements.
If it is 10 links over 10 days, schedule 1 link per day.

Anchor generation via MCP

Use this input format: URL - required anchor. Pass the rules to the bot exactly as written:

  1. Keep context text on both sides of the anchor.
  2. Minimum length of one result: 150 characters.
  3. Diversify contexts and place anchors semantically.
  4. Do not change anchor text.
  5. Write in a dry style, without adjectives.
  6. Use casino context in surrounding text.
  7. At least 2 sentences per result.
  8. Do not use brand names in surrounding text; keep it neutral.
  9. Do not expose private domains in instructions/examples (use placeholders).

Ready prompt template

Create anchor contexts from a list in format: URL - anchor.

Rules:
1) Context must be on both sides of the anchor.
2) Minimum length for each result is 150 characters.
3) Diversify contexts and place anchors naturally.
4) Do not change anchor text.
5) Write dry, without adjectives.
6) Use casino context in surrounding text.
7) At least 2 sentences per result.
8) Keep surrounding text neutral and non-branded.
9) Do not reveal private URLs in explanations/examples.

Output format:
- Only a list of results.
- No extra explanations.
- One line per result (no line breaks inside a result).

Article generation from your prompt

Use tool link_manager_generate_and_create_project_articles. It follows your prompt as the primary instruction and does not force a rigid template.

Set env key for generation: LM_OPENAI_API_KEY (or OPENAI_API_KEY).

Example call

{
  "project_id": 1248,
  "prompt": "Write a rewrite article ... (paste your full prompt)",
  "source_html": "<h1>...</h1><p>...</p>",
  "count": 3
}