# MCP FreeScout

Сервер связывает ИИ-агента с FreeScout: он получает и разбирает обращения, меняет их статус и готовит черновики ответов. Нужен Node.js 24 или новее и доступ к API FreeScout.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 30
- Автор: verygoodplugins
- Лицензия: GPL-3.0 · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/verygoodplugins/mcp-freescout
- Обновлён: 2026-10-22
- HTML: https://affpapa.org/nevibecode/mcp/mcp-freescout

## Что делает

MCP FreeScout даёт агенту инструменты для работы с обращениями: можно получить переписку, определить тип проблемы и возможную причину, добавить внутреннюю заметку или назначить ответственного. Сервер также создаёт черновик ответа в FreeScout; Markdown при сохранении преобразуется в HTML.

Для запуска нужны Node.js 24 или новее, включённый API FreeScout, адрес экземпляра и API-ключ. Сервер использует stdio и устанавливается через `npx`. Без API-доступа к FreeScout он не сможет читать и обновлять обращения.

## Требования
- Нужно: Node.js (команды через npx)
- Переменные окружения: `FREESCOUT_URL`, `FREESCOUT_API_KEY`, `FREESCOUT_DEFAULT_USER_ID` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
claude mcp add --env FREESCOUT_URL=<FREESCOUT_URL> --env FREESCOUT_API_KEY=<FREESCOUT_API_KEY> --env FREESCOUT_DEFAULT_USER_ID=<FREESCOUT_DEFAULT_USER_ID> --transport stdio mcp-freescout -- npx -y @verygoodplugins/mcp-freescout
```
Вместо <…> подставьте свои значения

### Codex

**Командой платформы**
```bash
codex mcp add mcp-freescout --env FREESCOUT_URL=<FREESCOUT_URL> --env FREESCOUT_API_KEY=<FREESCOUT_API_KEY> --env FREESCOUT_DEFAULT_USER_ID=<FREESCOUT_DEFAULT_USER_ID> -- npx -y @verygoodplugins/mcp-freescout
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mcp-freescout": {
            "command": "npx",
            "args": [
                "-y",
                "@verygoodplugins/mcp-freescout"
            ],
            "env": {
                "FREESCOUT_URL": "<FREESCOUT_URL>",
                "FREESCOUT_API_KEY": "<FREESCOUT_API_KEY>",
                "FREESCOUT_DEFAULT_USER_ID": "<FREESCOUT_DEFAULT_USER_ID>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "mcp-freescout": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@verygoodplugins/mcp-freescout"
            ],
            "env": {
                "FREESCOUT_URL": "<FREESCOUT_URL>",
                "FREESCOUT_API_KEY": "<FREESCOUT_API_KEY>",
                "FREESCOUT_DEFAULT_USER_ID": "<FREESCOUT_DEFAULT_USER_ID>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e FREESCOUT_URL=<FREESCOUT_URL> -e FREESCOUT_API_KEY=<FREESCOUT_API_KEY> -e FREESCOUT_DEFAULT_USER_ID=<FREESCOUT_DEFAULT_USER_ID> mcp-freescout npx -y @verygoodplugins/mcp-freescout
```
Вместо <…> подставьте свои значения

## Когда брать
- разобрать обращение и определить возможную причину
- найти обращение по ID, номеру или URL
- добавить внутреннюю заметку для команды
- изменить статус обращения или назначить ответственного
- сохранить черновик ответа в FreeScout

## Примеры запросов агенту
- Разбери обращение FreeScout с номером 12345 и определи тип проблемы и возможную причину.
- Добавь внутреннюю заметку к обращению 12345: клиент подтвердил, что исправление работает.
- Подготовь черновик ответа для обращения 12345, чтобы я проверил его перед отправкой.

## Похожие
- [REA](https://affpapa.org/nevibecode/mcp/rea.md) — MCP-сервер · ★ 386989
- [GitHub](https://affpapa.org/nevibecode/mcp/github.md) — MCP-сервер · ★ 33918
- [World Monitor](https://affpapa.org/nevibecode/mcp/world-monitor.md) — MCP-сервер · ★ 89408
- [Netdata](https://affpapa.org/nevibecode/mcp/netdata.md) — MCP-сервер · ★ 81115
- [Front-End Checklist](https://affpapa.org/nevibecode/mcp/front-end-checklist.md) — MCP-сервер · ★ 74559
- [Scrapling MCP Server](https://affpapa.org/nevibecode/mcp/scrapling-mcp-server.md) — MCP-сервер · ★ 89433

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md