Teletype MCP

Локальный MCP-сервер для управления публикациями на teletype.in. Он запускается на компьютере пользователя и не требует Vercel, другого хостинга или постоянно работающего внешнего сервера.

Как это работает

ChatGPT / Claude / Cursor / другой MCP-клиент
                │ stdio
                ▼
       локальный server.js
                │ HTTPS
                ▼
            teletype.in

Сервер работает только пока запущен MCP-клиент. Токены и настройки хранятся в локальном .env и не отправляются в GitHub.

Related MCP server: writefreely-mcp-server

Два режима

• DRAFT_ONLY — агент может создавать и редактировать только скрытые материалы. Открытая публикация заблокирована кодом.

• AUTO_PUBLISH — агент может создать материал и сразу опубликовать его открыто.

По умолчанию используется DRAFT_ONLY.

Установка для Windows — рекомендуемый вариант

Нужен Node.js 20 или новее.

1. Установи Node.js 20+ с официального сайта: https://nodejs.org/

2. Скачай репозиторий через Code → Download ZIP или клонируй его через Git.

3. Распакуй архив и открой папку teletype-mcp.

4. Дважды запусти файл install.cmd.

5. Установщик проверит Node.js, установит зависимости, задаст вопросы для .env и создаст файлы запуска.

Если Windows показывает предупреждение SmartScreen, выбери «Подробнее → Выполнить в любом случае»: скрипт работает только внутри папки проекта и не отправляет секреты наружу.

Если запускаешь из PowerShell

.install.ps1

Если PowerShell блокирует .ps1, используй install.cmd или выполни:

Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
.install.ps1

Ручной вариант

npm.cmd install
node setup.mjs

На macOS/Linux:

chmod +x install.sh
./install.sh

Установщик создаёт .env, mcp-config.json, start-teletype-mcp.cmd, start-teletype-mcp.ps1 и, на macOS/Linux, start-teletype-mcp.sh. Реальные значения .env остаются только на компьютере пользователя.

Запуск после установки

На Windows просто запусти start-teletype-mcp.cmd двойным щелчком. Для PowerShell:

.\start-teletype-mcp.ps1

В macOS/Linux запусти ./start-teletype-mcp.sh. Пустое окно терминала — нормальное поведение: сервер ждёт команды от MCP-клиента. Не закрывай его, если клиент не запускает сервер самостоятельно.

Подключение к MCP-клиенту

Установщик создаёт файл mcp-config.json с уже подставленными абсолютными путями. Скопируй его содержимое в конфигурацию MCP-клиента, который поддерживает локальные серверы через stdio:

{
  "mcpServers": {
    "teletype": {
      "command": "C:/Program Files/nodejs/node.exe",
      "args": ["C:/путь/к/teletype-mcp/server.js"]
    }
  }
}

На Windows укажи полный путь к server.js. На macOS/Linux пример выглядит так:

{
  "mcpServers": {
    "teletype": {
      "command": "node",
      "args": ["/полный/путь/к/teletype-mcp/server.js"]
    }
  }
}

После перезапуска MCP-клиента появятся инструменты check_connection, get_profile, create_article, update_article, publish_article, list_articles и get_article. Первой командой попроси агента выполнить check_connection.

Важно: не каждый веб-чат поддерживает подключение локального stdio MCP. Если в ChatGPT нет раздела для локальных MCP-серверов, используй MCP-клиент с такой поддержкой, например Claude Desktop, Cursor или другой совместимый клиент. Сам MCP при этом уже работает локально и не зависит от Vercel.

Безопасность

Не добавляй в GitHub, сообщения или Notion:

• токены, cookies, session ID и CSRF;

• содержимое .env;

• личные URL и идентификаторы аккаунта;

• логи с приватными данными.

Перед включением AUTO_PUBLISH рекомендуется проверить работу в DRAFT_ONLY.

Проверка

npm run check
npm test

В Windows PowerShell используй npm.cmd run check и npm.cmd test, если команда npm блокируется политикой выполнения сценариев.

Частые ошибки

npm.ps1 cannot be loaded / выполнение сценариев отключено

Это ограничение PowerShell, а не ошибка проекта. Используй npm.cmd ..., запусти install.cmd или временно разреши скрипты только для текущего окна:

Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass

node is not recognized

Node.js не установлен или PowerShell открыт до его установки. Установи Node.js 20+, закрой все окна терминала и открой новое.

MCP подключился, но check_connection выдаёт 401/403

Проверь локальный .env: токен, TELETYPE_CLIENT_ID, TELETYPE_SESSION_ID, TELETYPE_LID и TELETYPE_CSRF должны относиться к одной актуальной сессии Teletype. Не отправляй их в чат.

TELETYPE_BLOG_ID не задан

Заполни идентификатор блога в .env или передай blog_id инструменту MCP. Пустой TELETYPE_BLOG_URI допустим.

Агент не видит инструменты

Проверь путь в mcp-config.json, перезапусти MCP-клиент и убедись, что используется полный путь к node.exe и server.js. Локальный сервер должен запускаться из папки проекта.

Статья создаётся скрытой

Это ожидаемо в DRAFT_ONLY. Для открытой автопубликации повторно запусти setup.mjs и выбери режим 2, но сначала протестируй соединение и создание скрытой статьи.