setup · fcakyon — команда для Claude Code: что делает и как установить
Команда setup настраивает ключ API для MCP-сервера Tavily в Claude Code и сохраняет его в конфигурационном файле плагина.
Apache-2.0 ★ 1 216 обновлён 2026-10-24
/plugin marketplace add fcakyon/claude-codex-settings
/plugin install tavily-tools@claude-settingsЧто делает setup
Команда проверяет файл ${CLAUDE_PLUGIN_ROOT}/.mcp.json. Если в поле tavily.env.TAVILY_API_KEY всё ещё стоит плейсхолдер REPLACE_WITH_TAVILY_API_KEY, сценарий запрашивает ключ у пользователя через интерфейс AskUserQuestion. Если ключ уже начинается с префикса tvly-, инструмент сообщает, что настройка уже выполнена.
Перед записью введённый ключ проходит валидацию: длина должна быть не менее 20 символов с обязательным префиксом tvly-. Затем создаётся резервная копия ${CLAUDE_PLUGIN_ROOT}/.mcp.json.backup, и только после этого обновляется основной конфиг.
Без перезапуска Claude Code новые параметры не вступят в силу. После завершения работы команды нужно выйти из сессии, запустить claude снова и проверить статус сервера через /mcp.
Какие задачи решает
- подключить Tavily MCP к Claude Code без ручного редактирования JSON
- проверить формат и длину ключа Tavily перед сохранением в конфиг
- создать резервную копию конфигурации
.mcp.jsonперед изменением параметров
Примеры запросов агенту
- /tavily-tools:setup
- Запусти команду
/tavily-tools:setup, чтобы настроить ключ для поиска Tavily
Как установить setup
1Через маркетплейс плагинов
/plugin marketplace add fcakyon/claude-codex-settings/plugin install tavily-tools@claude-settings2Вручную: положить файлы
.claude/commands/setup.mdВызов — /setup. Для всех проектов — ~/.claude/commands/
Вручную: положить файлы
~/.codex/prompts/setup.mdВызов — /prompts:setup. В Codex этот формат помечен устаревшим, замена — скиллы
Вручную: положить файлы
.github/prompts/setup.prompt.mdВручную: положить файлы
.gemini/commands/setup.tomlGemini хранит команды в TOML: текст запроса — в поле prompt
Вопросы о setup
Как установить setup в Claude Code?
Выполните обе команды маркетплейса по порядку: /plugin marketplace add fcakyon/claude-codex-settings, затем /plugin install tavily-tools@claude-settings.
Что делает команда setup?
Она проверяет статус Tavily MCP, запрашивает и валидирует API-ключ, делает бэкап .mcp.json и прописывает значение в конфигурацию.
Почему после сохранения ключа поиск Tavily не начинает работать сразу?
Claude Code считывает переменные окружения MCP только при запуске. Нужно полностью перезапустить сессию claude и проверить подключение через /mcp.
Исходный текст
setup.md · Apache-2.0
---
description: Configure Tavily MCP server credentials
---
# Tavily Tools Setup
**Source:** [tavily-ai/tavily-mcp](https://github.com/tavily-ai/tavily-mcp)
Configure the Tavily MCP server with your API key.
## Step 1: Check Current Status
Read the MCP configuration from `${CLAUDE_PLUGIN_ROOT}/.mcp.json`.
Check if Tavily is configured:
- If `tavily.env.TAVILY_API_KEY` contains `REPLACE_WITH_TAVILY_API_KEY`, it needs configuration
- If it contains a value starting with `tvly-`, already configured
Report status:
- "Tavily MCP is not configured - needs an API key"
- OR "Tavily MCP is already configured"
## Step 2: Show Setup Guide
Tell the user:
```
To configure Tavily MCP, you need a Tavily API key.
Quick steps:
1. Go to app.tavily.com and sign in
2. Navigate to API Keys
3. Create a new API key
4. Copy the key (starts with tvly-)
Free tier: 1,000 searches/month
Don't need Tavily MCP? Disable it via /mcp command.
```
## Step 3: Ask for Key
Use AskUserQuestion:
- question: "Do you have your Tavily API key ready?"
- header: "Tavily Key"
- options:
- label: "Yes, I have it"
description: "I have my Tavily API key ready to paste"
- label: "No, skip for now"
description: "I'll configure it later"
If user selects "No, skip for now":
- Tell them they can run `/tavily-tools:setup` again when ready
- Remind them they can disable Tavily MCP via `/mcp` if not needed
- Exit
If user selects "Yes" or provides key via "Other":
- If they provided key in "Other" response, use that
- Otherwise, ask them to paste the key
## Step 4: Validate Key
Validate the provided key:
- Must start with `tvly-`
- Must be at least 20 characters
If invalid:
- Show error: "Invalid key format. Tavily keys start with 'tvly-'"
- Ask if they want to try again or skip
## Step 5: Update Configuration
1. Read current `${CLAUDE_PLUGIN_ROOT}/.mcp.json`
2. Create backup at `${CLAUDE_PLUGIN_ROOT}/.mcp.json.backup`
3. Update `tavily.env.TAVILY_API_KEY` value to the actual key
4. Write updated configuration back to `${CLAUDE_PLUGIN_ROOT}/.mcp.json`
## Step 6: Confirm Success
Tell the user:
```
Tavily MCP configured successfully!
IMPORTANT: Restart Claude Code for changes to take effect.
- Exit Claude Code
- Run `claude` again
To verify after restart, run /mcp and check that 'tavily' server is connected.
```
© Fatih C. Akyon · Apache-2.0 · fcakyon/claude-codex-settings
Похожие слэш-команды
Все слэш-команды по теме «Настройка агента: память, контекст, субагенты» →Сначала — setup от других авторов.