Social Connect MCP POC

Node.js-22-POC ohne npm-Abhängigkeiten zum Testen der Facebook-/TikTok-Verbindung, von OAuth und der MCP-Connection-Tools.

1. Sofort mit Mock ausführen

cp .env.example .env
npm test
npm start

Öffne http://localhost:3000 und klicke anschließend auf Test Facebook, Test TikTok oder Run test-all.

.env.example hat standardmäßig MOCK_SOCIAL=true, sodass die Demo sofort ohne Secrets ausgeführt werden kann.

Related MCP server: Social MCP Connector

2. Zugriff auf echte Endpoints testen

npm run probe

Ein HTTP-Statuscode 400/401 ohne Token bedeutet trotzdem, dass der Provider-Endpoint erreichbar ist.

3. Facebook LIVE ausführen

Erstelle eine Meta Developer App, füge Facebook Login hinzu und konfiguriere:

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 für das POC:

pages_show_list
pages_read_engagement
pages_manage_posts
pages_manage_engagement
pages_messaging

Öffne dann:

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

Der Callback tauscht den Autorisierungscode gegen einen User-Access-Token, ruft /me und /me/accounts auf und hält den Token temporär im Speicher.

Du kannst OAuth auch umgehen, um Token/Page direkt zu testen:

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

4. TikTok LIVE ausführen

Erstelle eine TikTok Developer App + Login Kit und konfiguriere:

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

Öffne:

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

Der Callback verwendet den Token-v2-Endpoint und testet danach /v2/user/info/. Wenn die App video.list hat, testet das PUnzOC auch /v2/video/list/.

Oder teste den Token direkt:

TIKTOK_ACCESS_TOKEN=...

5. Interne 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

Tools:

social_status
facebook_test_connection
tiktok_test_connection

src/mcp-server.js ist eine minimale stdio-JSON-RPC-MCP-Implementierung, damit das POC nicht von externen Paketen abhängt. Beim Wechsel in die Produktion sollte sie durch das offizielle MCP SDK ersetzt werden.

7. TODO für die Produktion

Das POC hält OAuth-Tokens absichtlich nur im Speicher. Die Produktion benötigt eine Datenbank bzw. einen verschlüsselten Secret Store, Refresh-Token-Rotation, Meta/TikTok-Webhook-Verifizierung, RBAC, Audit-Log, Rate-Limit/Retry, App Review und einen Token-Revocation-Flow.

8. Git

Das Repository wurde bereits mit git init initialisiert. Zum Pushen auf GitHub nach dem Erstellen des Remote-Repositorys:

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