Sp MCP Server

MCP server that lets Claude publish directly to Instagram accounts linked to Sp platform users.

Deployment

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

After the first deploy, Cloudflare gives you a URL in the format:

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

You must update MCP_BASE_URL in the wrangler.toml file with that same URL, and run npm run deploy again.

Related MCP server: Instagram Complete MCP Server

Connecting from Claude

The user goes to Claude settings → Connectors → Add custom connector, and enters:

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

Claude will automatically discover the OAuth endpoints (/.well-known/oauth-authorization-server), and will take them to the login page (/authorize) only the first time.

Available Tools

• list_connected_accounts — returns the linked Instagram accounts

• publish_instagram_post(caption, image_url, account_id?) — publishes an image with a caption

Security Notes

• Instagram tokens are stored in the sp_instagram_accounts table in the Supabase project, protected by Row Level Security

• Access from the Worker to the database is done via the service_role key (it intentionally bypasses RLS because it is Server-side trusted), so this key must remain completely secret and stored only as a Wrangler secret, never placed in the code.