# Сервер MCP Nuxt

> Используйте документацию Nuxt в ИИ-ассистентах с поддержкой Model Context Protocol.

## Что такое MCP?

MCP (Model Context Protocol) — стандартизированный протокол, который позволяет ИИ-ассистентам обращаться к внешним источникам данных и инструментам. Nuxt предоставляет MCP-сервер, чтобы ассистенты вроде Claude Code, Cursor и Windsurf могли напрямую получать документацию, записи блога и руководства по развёртыванию.

Сервер MCP даёт структурированный доступ к документации Nuxt, чтобы ИИ-инструментам было проще понимать контекст и помогать в разработке на Nuxt.

## Ресурсы

Сервер MCP Nuxt предоставляет такие ресурсы для обнаружения:

- **resource://nuxt-com/documentation-pages**: все страницы документации (по умолчанию v4.x)
- **resource://nuxt-com/blog-posts**: записи блога Nuxt, включая релизы и руководства
- **resource://nuxt-com/deploy-providers**: провайдеры развёртывания и хостинг-платформы

Доступ к ним в Claude Code и аналогах — через `@`.

## Инструменты

Инструменты MCP-сервера Nuxt сгруппированы по категориям:

### Документация

- **list_documentation_pages**: список страниц документации с категориями и краткой информацией; фильтр версий (3.x, 4.x или все)
- **get_documentation_page**: содержимое и метаданные страницы по пути
- **get_getting_started_guide**: руководство «с чего начать» для выбранной версии Nuxt

### Блог

- **list_blog_posts**: список постов с датами, категориями и тегами
- **get_blog_post**: содержимое поста по пути

### Развёртывание

- **list_deploy_providers**: провайдеры и платформы хостинга
- **get_deploy_provider**: детали и инструкции по пути

## Промпты

Готовые сценарии для типовых задач:

- **find_documentation_for_topic**: найти релевантную документацию по теме
- **deployment_guide**: инструкции по развёртыванию у выбранного хостера
- **migration_help**: помощь при миграции между версиями Nuxt

В Claude Code и подобных клиентах — через `/`.

## Настройка

Сервер MCP Nuxt работает по HTTP и подключается в разных средах.

### ChatGPT

<note icon="i-lucide-info">

**Пользовательские коннекторы MCP в ChatGPT** доступны для тарифов Pro и Plus в веб-версии.

</note>

1. **Включите режим разработчика:** Настройки → **Коннекторы** (Connectors) → **Дополнительно** (Advanced settings) → **Режим разработчика** (Developer mode)
2. **Откройте настройки ChatGPT**
3. **Вкладка «Коннекторы» → «Создать коннектор»** (Create a new connector):

  - Имя: `Nuxt`
  - URL MCP-сервера: `https://nuxt.com/mcp`
  - Аутентификация: **Нет** (`None`)
4. **Создайте коннектор**

Коннектор Nuxt появится в инструментах Composer при включённом режиме разработчика.

### Claude Code

<note icon="i-lucide-info">

**Установите Claude Code** — см. [документацию Anthropic](https://code.claude.com/docs/en/quickstart).

</note>

```bash
claude mcp add --transport http nuxt-remote https://nuxt.com/mcp
```

### Claude Desktop

#### Инструкция по настройке

1. Откройте Claude Desktop → **Настройки** → **Developer** (разработчик)
2. Нажмите **Edit Config** (изменить конфигурацию) — откроется локальная папка Claude
3. Отредактируйте `claude_desktop_config.json`:
```json [claude_desktop_config.json]
{
  "mcpServers": {
    "nuxt": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://nuxt.com/mcp"
      ]
    }
  }
}
```
4. Перезапустите Claude Desktop

### Cursor

<u-button color="neutral" icon="i-custom-cursor" label="Установить сервер MCP" to="cursor://anysphere.cursor-deeplink/mcp/install?name=nuxt&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vbnV4dC5jb20vbWNwIn0%3D">



</u-button>

Вручную:

1. **Настройки** (Settings) → **Инструменты и MCP** (Tools & MCP) → добавьте конфигурацию Nuxt MCP

Или `.cursor/mcp.json` в корне проекта:

```json [.cursor/mcp.json]
{
  "mcpServers": {
    "nuxt": {
      "type": "http",
      "url": "https://nuxt.com/mcp"
    }
  }
}
```

### Le Chat Mistral

1. **Intelligence** → **Коннекторы** (Connectors)
2. **Добавить коннектор** (Add Connector) → **Пользовательский MCP-коннектор** (Custom MCP Connector)
3. Имя коннектора: `Nuxt`, сервер: `https://nuxt.com/mcp`

### Visual Studio Code

<note icon="i-lucide-info">

Нужны расширения [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) и [GitHub Copilot Chat](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot-chat).

</note>

1. Палитра команд (Ctrl/Cmd + Shift + P)
2. Выполните команду **Preferences: Open Workspace Settings (JSON)**
3. В проекте откройте или создайте папку `.vscode`
4. Создайте или отредактируйте `mcp.json`:

```json [.vscode/mcp.json]
{
  "servers": {
    "nuxt": {
      "type": "http",
      "url": "https://nuxt.com/mcp"
    }
  }
}
```

### GitHub Copilot Agent

<note icon="i-lucide-info">

Нужны права администратора репозитория для настройки MCP у агента написания кода (Coding agent).

</note>

Конфигурация аналогична VS Code (для агента используется ключ `mcpServers` вместо `servers`), плюс ключ `tools` для списка доступных инструментов.

1. Перейдите в репозиторий на GitHub
2. **Настройки** (Settings) → **Code & automation** → **Copilot** → **Coding agent**
3. В разделе **конфигурации MCP** (MCP configuration) добавьте:
```json
{
  "mcpServers": {
    "nuxt": {
      "type": "http",
      "url": "https://nuxt.com/mcp",
      "tools": ["*"]
    }
  }
}
```
4. Нажмите **Сохранить** (Save)

#### Проверка конфигурации

Чтобы убедиться, что MCP-сервер настроен верно:

1. Создайте issue в репозитории и назначьте его Copilot
2. Дождитесь, пока Copilot откроет pull request
3. В pull request нажмите **View session** в событии временной шкалы «Copilot started work»
4. Нажмите кнопку с многоточием (**...**) в правом верхнем углу, затем откройте **Copilot** на боковой панели
5. Разверните шаг **Start MCP Servers** и убедитесь, что отображаются настроенные инструменты Nuxt

Подробнее: [расширение агента написания кода с помощью MCP](https://docs.github.com/en/copilot/how-tos/use-copilot-agents/coding-agent/extend-coding-agent-with-mcp).

### Windsurf

1. **Настройки** (Settings) → **Windsurf Settings** → **Cascade** → **Управление MCP** (Manage MCPs) → **Сырой JSON** (View raw config)
2. Добавьте:

```json [.codeium/windsurf/mcp_config.json]
{
  "mcpServers": {
    "nuxt": {
      "type": "http",
      "url": "https://nuxt.com/mcp"
    }
  }
}
```

### Zed

1. **Настройки** (Settings) → **Open Settings** → JSON
2. Добавьте context server:

```json [.config/zed/settings.json]
{
  "context_servers": {
    "nuxt": {
      "source": "custom",
      "command": "npx",
      "args": ["mcp-remote", "https://nuxt.com/mcp"],
      "env": {}
    }
  }
}
```

### Opencode

1. В корне проекта создайте `opencode.json`
2. Добавьте:

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "nuxt": {
      "type": "remote",
      "url": "https://nuxt.com/mcp",
      "enabled": true
    }
  }
}
```

## Примеры промптов

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

- «Перечисли все страницы документации Nuxt»
- «Покажи введение в документации»
- «В чём отличие v3 и v4?»
- «Как развернуть на Vercel?»
- «Последние посты в блоге»
- «Помоги мигрировать с Nuxt 3 на Nuxt 4»
- «Найди документацию по композаблам»
- «Гайды по развёртыванию на Cloudflare»

Ассистент обратится к MCP-серверу за структурированными JSON-данными и сможет дать целенаправленную помощь при разработке на Nuxt.