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를 사용하므로 secret 없이 바로 데모할 수 있습니다.

Related MCP server: Social MCP Connector

2. 실제 엔드포인트 접근 가능 여부 테스트

npm run probe

토큰이 없어도 HTTP 400/401이 반환되면 provider 엔드포인트에 연결 가능하다는 의미입니다.

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

POC용 OAuth scopes:

pages_show_list
pages_read_engagement
pages_manage_posts
pages_manage_engagement
pages_messaging

그런 다음 다음을 엽니다:

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

콜백은 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

콜백은 token 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는 외부 패키지를 사용하지 않는 minimal stdio JSON-RPC MCP 구현입니다. 프로덕션으로 전환할 때는 공식 MCP SDK로 교체해야 합니다.

7. 프로덕션 TODO

POC는 의도적으로 OAuth 토큰을 메모리에만 보관합니다. 프로덕션에서는 database/암호화된 secret store, refresh-token rotation, Meta/TikTok 웹훅 검증, Microsoft 365 RBAC, audit log, rate-limit/retry, App Review 및 token revocation 흐름이 필요합니다.

8. Git

저장소는 이미 git init되어 있습니다. 원격 저장소를 만든 후 GitHub로 푸시하려면:

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