Sp MCP Server

Sp MCP 서버는 Claude가 Sp 플랫폼 사용자에게 연결된 Instagram 계정에 직접 게시할 수 있게 해줍니다.

배포 (Deploy)

cd mcp-server
npm install
npx wrangler login

# سرّيات لازم تضيفها قبل أول deploy:
npx wrangler secret put SUPABASE_SERVICE_ROLE_KEY
# (خذها من Supabase Dashboard → Settings → API → service_role secret)

npx wrangler secret put IG_APP_ID
npx wrangler secret put IG_APP_SECRET
# (App ID/Secret تبع تطبيق randieb من Meta for Developers)

npm run deploy

첫 배포 후, Cloudflare가 다음 형식의 URL을 제공합니다:

https://sp-mcp.<subdomain>.workers.dev

반드시 wrangler.toml 파일의 MCP_BASE_URL을 이 URL로 업데이트하고, npm run deploy를 다시 실행해야 합니다.

Related MCP server: Instagram Complete MCP Server

Claude에서 연결

사용자는 Claude 설정 → Connectors → Add custom connector로 이동하여 다음을 입력합니다:

https://sp-mcp.<subdomain>.workers.dev/mcp

Claude는 OAuth 엔드포인트(/.well-known/oauth-authorization-server)를 자동으로 감지하고, 처음 한 번만 로그인 페이지(/authorize)로 안내합니다.

사용 가능한 도구 (Tools)

• list_connected_accounts — 연결된 Instagram 계정 목록 반환

• publish_instagram_post(caption, image_url, account_id?) — 캡션과 함께 이미지 게시

보안 참고 사항

• Instagram 토큰은 Supabase 프로젝트의 sp_instagram_accounts 테이블에 저장되며, Row Level Security로 보호됩니다

• Worker에서 데이터베이스로의 접근은 service_role key를 통해 이루어지며(서버 측 신뢰 환경이므로 의도적으로 RLS를 우회), 이 키는 완전히 비밀로 유지되어야 하며 Wrangler secret으로만 저장되고 코드에 절대 포함되어서는 안 됩니다