MCP-сервер

Подключите Tellfair к ИИ-агенту — Claude, Cursor, VS Code, Zed, Windsurf — и просите озвучку обычными словами: «озвучь этот абзац голосом диктора», «сделай аудиокнигу из файла», «сколько у меня символов». Работает по API-ключу из кабинета (тарифы «Про» и «Студия»), символы и лимиты — как в студии.

Два способа подключения

Удалённый сервер	`https://tellfair.com/mcp` (Streamable HTTP). Ничего ставить не нужно, ключ — в заголовке `Authorization: Bearer …`.
Пакет `tellfair-mcp`	Запускается через `npx` (нужен Node.js 18+), ключ — в переменной `TELLFAIR_API_KEY`. Умеет всё то же и ещё работает с файлами на вашем диске: сохраняет звук, загружает свой голос и видео.

Ключ создаётся в кабинете → «API-ключи». Не вставляйте его в адрес сервера и не коммитьте в репозиторий: файлы настроек с ключом держите вне git или берите ключ из переменной окружения.

Настройка

Claude Code

Одна команда в терминале:

claude mcp add --transport http tellfair https://tellfair.com/mcp \
  --header "Authorization: Bearer tf_live_ваш_ключ"

Claude Desktop

«Настройки» → «Разработчик» → «Изменить конфигурацию» (claude_desktop_config.json), затем перезапустите приложение:

{
  "mcpServers": {
    "tellfair": {
      "command": "npx",
      "args": ["-y", "tellfair-mcp"],
      "env": { "TELLFAIR_API_KEY": "tf_live_ваш_ключ" }
    }
  }
}

Cursor

Файл ~/.cursor/mcp.json (для всех проектов) или .cursor/mcp.json в проекте:

{
  "mcpServers": {
    "tellfair": {
      "url": "https://tellfair.com/mcp",
      "headers": { "Authorization": "Bearer tf_live_ваш_ключ" }
    }
  }
}

VS Code (Copilot, режим агента)

Файл .vscode/mcp.json — ключ спросит при первом запуске и сохранит в защищённом хранилище:

{
  "inputs": [
    { "type": "promptString", "id": "tellfair-key", "description": "API-ключ Tellfair", "password": true }
  ],
  "servers": {
    "tellfair": {
      "type": "http",
      "url": "https://tellfair.com/mcp",
      "headers": { "Authorization": "Bearer ${input:tellfair-key}" }
    }
  }
}

Windsurf

Файл ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "tellfair": {
      "serverUrl": "https://tellfair.com/mcp",
      "headers": { "Authorization": "Bearer tf_live_ваш_ключ" }
    }
  }
}

Zed

В settings.json:

"context_servers": {
  "tellfair": {
    "command": "npx",
    "args": ["-y", "tellfair-mcp"],
    "env": { "TELLFAIR_API_KEY": "tf_live_ваш_ключ" }
  }
}

Любой другой клиент с MCP: удалённый сервер https://tellfair.com/mcp с заголовком Authorization или команда npx -y tellfair-mcp с переменной TELLFAIR_API_KEY.

Что умеет

`list_voices`	Пресеты, встроенные голоса, голоса Piper и ваши клонированные голоса.
`speak`	Озвучить текст до 5000 символов — mp3, wav или opus, звук приходит сразу.
`start_job`	Длинный текст или аудиокнига до 200 000 символов — в очередь.
`start_dialog`	Диалог на несколько голосов по сценарию «Имя: реплика».
`get_job / list_jobs`	Статус задач и ссылка на готовый файл.
`get_balance / get_usage`	Тариф, остаток символов и история списаний.

Только в пакете — работа с файлами на диске:

`speak_to_file`	Озвучить и сохранить файл на диск.
`save_job_file`	Скачать готовую задачу в файл.
`add_voice`	Загрузить свой голос из файла — только с подтверждением согласия владельца голоса.
`dub_video`	Озвучить видео по субтитрам.

Всё это есть и в обычном API.

Мини-кабинет в редакторе

Если хочется видеть баланс и быстро озвучить фразу без агента — откройте мини-кабинет во встроенном браузере. Ссылка — в кабинете → «Мини-кабинет».

VS Code, Cursor, Windsurf	`Ctrl`+`Shift`+`P` → «Simple Browser: Show» → вставьте ссылку. Панель можно перетащить вбок, рядом с кодом.
JetBrains (IntelliJ, WebStorm, PyCharm…)	Своего браузера с адресной строкой в JetBrains нет: поставьте из Marketplace плагин встроенного браузера (поиск «browser») и откройте ссылку в нём.
OBS	«Док-панели» → «Пользовательские браузерные доки» → вставьте ссылку.

Ссылка работает как пароль к озвучке за ваши символы. Если она утекла — выдайте новую в кабинете, старая сразу перестанет работать.