К основному содержанию
скилл CX Codex

parallel-mcp-setup — скилл для Claude Code

Скилл parallel-mcp-setup пошагово настраивает авторизованное подключение Parallel Search MCP через шлюз Bifrost: ключ, доступы, проверка вызовов.

MIT 1 600 установок ★ 97 обновлён 2026-10-21

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add parallel-web/parallel-agent-skills --skill parallel-mcp-setup -a claude-code
Открыть на GitHub

Что делает parallel-mcp-setup

Скилл описывает полный путь подключения Parallel Search MCP через Bifrost. Начинает с инспекции деплоймента: какой экземпляр Bifrost используется, где лежит конфигурация — в дашборде или config.json, какой агент или виртуальный ключ будет ходить в поиск. Перед изменениями скилл требует проверить существующие MCP-клиенты, чтобы обновить нужное подключение Parallel, а не создать дубликат.

Подключение идёт на https://search.parallel.ai/mcp-oauth с обязательной авторизацией. Для общего ключа в переменной PARALLEL_MCP_AUTHORIZATION на сервере Bifrost задаётся значение Bearer <Parallel API key>; в настройках клиента выбирается Headers auth, а Authorization ссылается на переменную через env-выбор. Для файловых деплойментов скилл даёт готовый JSON-блок для слияния с mcp.client_configs — в нём tools_to_execute ограничен web_search и web_fetch.

Проверка идёт через Bifrost: убедиться, что оба инструмента обнаружены, что downstream-агент их видит, затем выполнить маленький поиск документации Python asyncio и забрать один URL из результатов. При 401/403 проверяется ключ Parallel и права аккаунта, при 400 в handshake — переопределения поиска. Секреты запрещено класть в файлы скилла, промпты или аргументы инструментов; они живут только в менеджере секретов или окружении. Для публикации скилла в маркетплейсе Bifrost используется имя bifrost-parallel-mcp-setup.

Какие задачи решает

  • поднять авторизованное MCP-подключение Parallel Search через Bifrost
  • обновить существующий клиент Parallel, не создавая дубликатов
  • ограничить доступные инструменты до web_search и web_fetch
  • продиагностировать 401/403 и 400 при настройке соединения
  • проверить, что downstream-агент реально видит оба инструмента

Примеры запросов агенту

  • Настрой Parallel Search MCP через Bifrost с Headers-авторизацией
  • Проверь подключение Parallel: пусть агент найдёт документацию asyncio и заберёт один URL
  • Разберись, почему Bifrost отдаёт 401 при вызове web_search

Как установить parallel-mcp-setup

1Через Skills CLI (Vercel)

npx skills add parallel-web/parallel-agent-skills --skill parallel-mcp-setup -a claude-code

2Вручную: положить файлы

~/.claude/skills/parallel-mcp-setup/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/parallel-mcp-setup/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о parallel-mcp-setup

Как установить parallel-mcp-setup в Claude Code?

Выполни npx skills add parallel-web/parallel-agent-skills --skill parallel-mcp-setup -a claude-code. Скилл окажется в ~/.claude/skills/parallel-mcp-setup/SKILL.md.

Что делает parallel-mcp-setup?

Описывает установку и настройку авторизованного подключения Parallel Search MCP через шлюз Bifrost: выбор метода авторизации, конфигурацию клиента, доступы к инструментам и проверку вызовов.

Почему нельзя просто вставить Parallel API key в конфиг клиента?

Скилл требует хранить секреты только в менеджере секретов или окружении деплоймента. В файлы скилла, промпты, source control и аргументы инструментов ключ класть запрещено.

Исходный текст

SKILL.md · MIT
---
name: parallel-mcp-setup
description: Use when installing, configuring, or troubleshooting an authenticated Parallel Search MCP connection in Bifrost, including gateway-level search settings and downstream tool access.
---

# Set up Parallel MCP

Configure and verify authenticated Parallel MCP connections. The first supported setup path is Parallel Search MCP through Bifrost; the steps below apply to that path. Tool descriptions supplied by the MCP server govern search and fetch usage; this skill covers installation and gateway configuration.

## 1. Inspect the deployment

Identify the target Bifrost instance, its configuration source (dashboard or `config.json`), and the intended downstream agent or virtual key. Inspect existing MCP clients before changing anything; update the matching Parallel connection instead of adding duplicates. Preserve unrelated clients, access rules, and tool approval settings.

Confirm access to Bifrost management and a Parallel account credential. These are separate from the downstream agent's Bifrost credential. If access or a secret is missing, prepare the configuration and report what is needed without claiming installation succeeded. Keep secrets in the deployment's secret manager or environment; never put them in skill files, source control, prompts, or tool arguments.

## 2. Configure the authenticated connection

Use `https://search.parallel.ai/mcp-oauth`, which requires authentication. Choose Headers auth for a shared Parallel API key, or Bifrost's OAuth flow when that is the deployment's chosen authentication method. Do not change an authentication failure into an unauthenticated connection.

For shared-key configuration, provision `PARALLEL_MCP_AUTHORIZATION` in the **Bifrost server environment** with the complete value `Bearer <Parallel API key>`. The `env.` reference substitutes the whole header value; it does not prepend `Bearer`.

In **MCP Gateway → New MCP Server**, choose HTTP, the URL above, and Headers auth. Set `Authorization` to the environment-variable reference using the UI's env-var picker. Allow `web_search` and `web_fetch` for this connection.

For a file-managed deployment, merge this client entry into the existing `mcp.client_configs` array:

```json
{
  "name": "parallel-search",
  "connection_type": "http",
  "connection_string": "https://search.parallel.ai/mcp-oauth",
  "auth_type": "headers",
  "headers": {
    "Authorization": "env.PARALLEL_MCP_AUTHORIZATION"
  },
  "is_ping_available": false,
  "tools_to_execute": ["web_search", "web_fetch"]
}
```

For OAuth, use the same endpoint with Bifrost's OAuth auth type and complete its admin verification/sign-in flow. Use per-user authentication only when each caller should use their own Parallel account. See [Bifrost authentication](https://docs.getbifrost.ai/mcp/auth/overview) for the chosen flow.

Respect the deployment's reload procedure. Existing connection URL/auth-type changes may require replacing the client because Bifrost treats those fields as immutable; plan that replacement without deleting a working client first. File-managed entries must be updated in the file as well, or a restart can recreate the old configuration.

## 3. Configure gateway controls and access

Keep Parallel’s defaults by omitting search-setting headers and URL parameters. When the user explicitly requests a particular search mode, source policy, or response budget, read [gateway search controls](./references/gateway-controls.md). Apply these as upstream connection settings. Keep the chosen credential and search policy under gateway administration; do not enable caller-supplied overrides of these headers unless explicitly intended.

Confirm Bifrost discovers both tools and grants the intended downstream client or virtual key access to them. Connect the agent to the deployment's Bifrost MCP gateway with its configured downstream authentication. Use the actual discovered tool names, which may be prefixed. Installing this skill does not itself register or expose the MCP tools.

## 4. Verify through Bifrost

1. Confirm the upstream connection is healthy and authenticated, with `web_search` and `web_fetch` discovered.
2. Confirm the intended downstream agent can discover both tools through Bifrost.
3. Run a small search for official Python asyncio documentation, then fetch a returned documentation URL. Use the tools' current schemas and descriptions. Confirm successful results and inspect per-URL errors.
4. Inspect Bifrost's tool-call records to confirm the intended connection was used. Verify account attribution and any configured mode or source policy in available upstream request metadata or account logs; result quality alone does not prove the mode used.
5. Report exactly what was verified and what remains untested. A direct request to Parallel does not prove Bifrost routing, authentication, or downstream permissions.

On a 401/403, check the Parallel credential, account access, and upstream auth configuration. On a handshake 400, check the configured search overrides. For missing tools, inspect connection health and gateway filtering. Keep existing access controls while diagnosing failures.

## Optional: distribute this setup skill through Bifrost

In **Skills Repository → New Skill**, copy this file's name and description into Details, paste only the Markdown body into the SKILL.md editor, and attach `references/gateway-controls.md`. For an existing skill, create a new version. Publish an initial version such as `1.0.0`, then use **Register as Marketplace** and the dashboard's installation commands; the plugin name is `bifrost-parallel-mcp-setup`.

Bifrost serves newly created skills immediately and documents marketplace/download routes as public. Keep deployment credentials and private configuration out of published files. Skill publication is separate from MCP connection setup.

## Sources

- [Parallel Search MCP](https://docs.parallel.ai/integrations/mcp/search-mcp)
- [Bifrost MCP connections](https://docs.getbifrost.ai/mcp/connecting-to-servers)
- [Bifrost header authentication](https://docs.getbifrost.ai/mcp/auth/headers)
- [Bifrost Skills Repository](https://docs.getbifrost.ai/features/skills-repository)

© parallel-web · MIT · parallel-web/parallel-agent-skills

Похожие скиллы

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
setup-matt-pocock-skills Matt Pocock Скилл setup-matt-pocock-skills настраивает репозиторий для инженерных скиллов Matt Pocock: задаёт трекер задач, метки триажа и расположение доменной документации. Запустите его перед первым использованием остальных скиллов. CX Codex +1 1 052 851установок k-skill-setup NomaDamas Скилл k-skill-setup развёртывает набор k-skill через CLI, определяет среду выполнения и контролирует обновление навыков агента. Защищает от утечки учётных данных. CX Codex +1 13 800установок cyrus-setup-repository cyrusagents Скилл cyrus-setup-repository подключает Git-репозитории к конфигурации Cyrus, чтобы агент брал задачи из нужных кодбаз. Пригодится при первом запуске Cyrus или когда в работу берётся новый проект. CX Codex +1 1 100установок improve-my-agent-setup Kurt Buhler Скилл improve-my-agent-setup для Claude Code проверяет настройки разработки с ИИ-агентами и предлагает улучшения. Запускается для аудита рабочего процесса или оценки его настроек. CX Codex +1 ★ 1 104звёзд репо improve-agent-setup jackulau Скилл improve-agent-setup для Claude Code разбирает ошибки в записях сессий агента и предлагает улучшения для его инструкций. Запускается по просьбе найти повторяющуюся ошибку или оценить, помогло ли изменение правила. CX Codex +1 ★ 149звёзд репо operator-setup wrg32786 Скилл operator-setup для Claude Code проводит первое интервью о бизнесе и его задачах. После ответов он сохраняет сведения о работе оператора и предлагает три персональных следующих шага. CX Codex +1 ★ 26звёзд репо

Из того же набора14

Весь набор →
parallel-findall Скилл parallel-findall для Claude Code находит компании, людей и продукты по описанию и собирает их в структурированный список. Ищет сущности, а не статьи или веб-страницы. CX Codex +1 13 000установок parallel-cli-setup Скилл parallel-cli-setup проводит агента по шагам: установка parallel-cli, вход в аккаунт, проверка баланса и установка остальных скиллов Parallel. CX Codex +1 6 600установок migrate-to-parallel Скилл migrate-to-parallel для Claude Code, Codex, Cursor и других IDE переносит интеграции с Exa, Tavily, Perplexity или Firecrawl на продукты Parallel, сохраняя поведение приложения. CX Codex +1 3 800установок parallel-memory Скилл parallel-memory достаёт из памяти прошлые запуски Parallel Task, Monitor и FindAll, когда они могут пригодиться, и удаляет их по запросу. CX Codex +1 2 900установок choose-your-parallel-api Скилл choose-your-parallel-api помогает агенту выбрать нужный Parallel API и настройки под задачу: свежие данные из веба, ответ со ссылками, разбор PDF или исследование по строкам таблицы. CX Codex +1 1 600установок parallel-search-setup Скилл parallel-search-setup для Claude Code. Настраивает и чинит MCP-сервер Parallel Search: проверяет регистрацию на https://search.parallel.ai/mcp, добавляет его, если нужно, и диагностирует проблемы с поиском и лимитами. CX Codex +1 1 500установок parallel-search-evaluation Скилл parallel-search-evaluation для Claude Code сравнивает качество, стоимость и задержку поисковых систем. Запускается при оценке Parallel, сравнении с Exa или Tavily и разборе результатов бенчмарков. CX Codex +1 734установок parallel-api Помогает встроить поиск, извлечение контента и исследования Parallel API в приложения через Python или TypeScript SDK. Включается при написании или отладке кода с Parallel. CX Codex +1 280установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой