Social Connect MCP POC

Node.js 22 POC без npm-зависимостей для тестирования подключений Facebook + TikTok, OAuth и инструментов подключения MCP.

1. Запуск сразу с mock

cp .env.example .env
npm test
npm start

Откройте http://localhost:3000, затем нажмите Test Facebook, Test TikTok или Run test-all.

В .env.example по умолчанию задано MOCK_SOCIAL=true, поэтому демо можно запустить сразу, без секретов.

Related MCP server: Social MCP Connector

2. Проверка доступа к реальному endpoint

npm run probe

HTTP 400/401 без токена всё равно означает, что endpoint провайдера доступен.

3. Запуск Facebook LIVE

Создайте Meta Developer App, добавьте Facebook Login и настройте:

MOCK_SOCIAL=false
META_GRAPH_VERSION=v26.0
META_APP_ID=...
META_APP_SECRET=...
META_REDIRECT_URI=http://localhost:3000/api/facebook/callback

OAuth scopes POC:

pages_show_list
pages_read_engagement
pages_manage_posts
pages_manage_engagement
pages_messaging

Затем откройте:

http://localhost:3000/api/facebook/login

Callback обменивает authorization code на user access token, вызывает /me и /me/accounts, а затем временно хранит токен в памяти.

Вы также можете обойти OAuth и протестировать токен/Page напрямую:

META_USER_ACCESS_TOKEN=...
# hoặc
META_PAGE_ID=...
META_PAGE_ACCESS_TOKEN=...

4. Запуск TikTok LIVE

Создайте TikTok Developer App + Login Kit и настройте:

MOCK_SOCIAL=false
TIKTOK_CLIENT_KEY=...
TIKTOK_CLIENT_SECRET=...
TIKTOK_REDIRECT_URI=http://localhost:3000/api/tiktok/callback
TIKTOK_SCOPES=user.info.basic,video.list

Откройте:

http://localhost:3000/api/tiktok/login

Callback использует token endpoint v2, а затем тестируют /v2/user/info/. Если у приложения есть video.list, POC также тестируют /v2/video/list/.

Или протестируйте токен напрямую:

TIKTOK_ACCESS_TOKEN=...

5. Внутренний API

GET /api/health
GET /api/facebook/login
GET /api/facebook/callback
GET /api/facebook/test
GET /api/tiktok/login
GET /api/tiktok/callback
GET /api/tiktok/test
GET /api/test-all

6. MCP POC

npm run mcp

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

social_status
facebook_test_connection
tiktok_test_connection

src/mcp-server.js — это минимальная реализация MCP поверх stdio JSON-RPC, чтобы POC не зависел от внешних пакетов. При переходе в production его следует заменить на официальный MCP SDK.

7. Production TODO

POC намеренно хранит OAuth-токены только в памяти. Для production необходимы: база данных/зашифрованное хранилище секретов, ротация refresh-токенов, проверка вебхуков Meta/TikTok, RBAC, журнал аудита, ограничение частоты запросов/повторные попытки, App Review и процедура отзыва токенов.

8. Git

Репозиторий уже проинициализирован (git init). Чтобы отправить его на GitHub, создайте удалённый репозиторий и выполните:

git remote add origin git@github.com:<username>/social-connect-mcp-poc.git
git push -u origin main