Sp MCP Server

MCP server 让 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

首次 deploy 后，Cloudflare 会给你一个链接，格式如下：

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

必须更新 wrangler.toml 文件中的 MCP_BASE_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 endpoints（/.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，因为它是 Server-side trusted），所以这个密钥必须完全保密，仅作为 Wrangler secret 保存，绝不能写进代码里