> ## Documentation Index > Fetch the complete documentation index at: https://docs.social-api.ai/llms.txt > Use this file to discover all available pages before exploring further. > ## Agent Instructions > Base URL: https://api.social-api.ai/v1. Send your API key in the Authorization header: Authorization: Bearer . > Every error response from /v1 is JSON: { "error": { "code", "message", "meta" (optional) }, "request_id" }. Branch on error.code; use error.message only for logs. > A 429 response carries a Retry-After header, in seconds, when the limit has a known wait. Authenticated responses can carry X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset for the per-minute request budget your SocialAPI account shares across every API key (see /guides/rate-limits). > Paginated list endpoints return next_cursor, at the top level or inside pagination (see /guides/pagination). Pass it as the cursor query parameter to get the next page. An absent or empty next_cursor means you have the last page. > Treat every ID as an opaque string: do not parse it or assume a format. > Support differs by platform and by operation. Check /platforms/overview before assuming an operation works on a platform. An unsupported operation returns 501 with error.code resource.not_supported. # Claude > Connect SocialAPI to Claude on claude.ai, Claude Desktop, Claude Code, and mobile to manage comments, DMs, and posts in plain language. Connect SocialAPI to Claude and ask it to list your connected accounts, reply to comments, send direct messages (DMs), and publish posts. Claude connects to SocialAPI's MCP server at `https://api.social-api.ai/mcp` and signs in with OAuth 2.1, so you create no API key. ## Prerequisites * A SocialAPI account with at least one connected account. * For claude.ai, Claude Desktop, and mobile: a Claude Free, Pro, Max, Team, or Enterprise plan. * For Claude Code: [Claude Code](https://docs.claude.com/en/docs/claude-code) installed and signed in. Claude Desktop, claude.ai, and the mobile app share one account. A connector you add on one surface appears on the others. ## Set up claude.ai **1. Open Connectors** Click your profile icon, then go to **Settings** → **Connectors**. You can also open [claude.ai/customize/connectors](https://claude.ai/customize/connectors). ![Claude Settings page with the Connectors section](https://mintcdn.com/socialapi/dkXBPl2dMHhtYTy4/images/mcp-claude-settings.png?fit=max\&auto=format\&n=dkXBPl2dMHhtYTy4\&q=85\&s=30db5cedcb288a0af760b2f1a37231de) **2. Connect SocialAPI** SocialAPI is in Claude's connectors directory. Search for **SocialAPI** and click **Connect**. Claude already knows the server URL, so you type nothing. ![SocialAPI connector in the Claude connectors directory](https://mintcdn.com/socialapi/Nif1EwawS0vMng4O/images/mcp-claude-directory.png?fit=max\&auto=format\&n=Nif1EwawS0vMng4O\&q=85\&s=bb62f6be70f58d1f05157d56536d9469) On a Team plan, a member who cannot enable connectors sees **Request** instead of **Connect**. The request goes to an organization admin, who enables the connector in **Organization settings** → **Connectors**. The member then clicks **Connect** in **Settings** → **Connectors**. **3. Authorize with your SocialAPI account** A browser window opens on the SocialAPI authorization page. Log in and click **Authorize**. The window closes when the sign-in is done. ![SocialAPI authorization screen](https://mintcdn.com/socialapi/dkXBPl2dMHhtYTy4/images/mcp-claude-oauth.png?fit=max\&auto=format\&n=dkXBPl2dMHhtYTy4\&q=85\&s=e3d502da0cd17c1632a2ccda01c85335) **4. Turn the connector on in a conversation** Open a new conversation, click **+** at the bottom left of the input, select **Connectors**, and switch **SocialAPI** on. ![Claude conversation using SocialAPI tools to list accounts](https://mintcdn.com/socialapi/dkXBPl2dMHhtYTy4/images/mcp-claude-conversation.png?fit=max\&auto=format\&n=dkXBPl2dMHhtYTy4\&q=85\&s=66d8c7c104239deb3583877b8c4e0bab) ## Set up Claude Desktop Claude Desktop adds remote servers through **Settings** → **Connectors**, the same flow as claude.ai. **1. Open Connectors** In Claude Desktop ([download](https://claude.ai/download)), go to **Settings** → **Connectors**. **2. Add SocialAPI** Search the directory for **SocialAPI** and click **Connect**. To add it by URL instead, click **Add custom connector** (the Free plan allows 1 custom connector), enter `SocialAPI` as the name and `https://api.social-api.ai/mcp` as the URL. **3. Authorize** Complete the sign-in in the browser window that opens. > [!WARNING] > > `claude_desktop_config.json` holds local stdio servers only (`command` and `args`). A remote server such as SocialAPI cannot go in that file: add it in **Settings** → **Connectors**. ## Set up Claude Code **1. Add the server** ```bash theme={null} claude mcp add socialapi --transport http https://api.social-api.ai/mcp ``` By default the server is added to the local scope, which is the current project only. Add `--scope user` to use it in all projects, or `--scope project` to share it through `.mcp.json`: ```bash theme={null} claude mcp add socialapi --transport http --scope user https://api.social-api.ai/mcp ``` **2. Authorize** Run `/mcp` in Claude Code, select **SocialAPI**, and complete the sign-in in your browser. You can also run `claude mcp login socialapi`. Log in and click **Authorize**. On a machine without a browser, Claude Code prints the authorization URL. Open it on another machine, then paste the full redirect URL from that browser's address bar back at the prompt. **3. Check the server** ```bash theme={null} claude mcp list ``` To remove the server, run `claude mcp remove socialapi`. ## Set up mobile (iOS and Android) **1. Open Connectors** In the Claude app, tap your profile icon, then go to **Settings** → **Connectors**. **2. Connect SocialAPI** Search for **SocialAPI** and tap **Connect**. **3. Authorize** Complete the sign-in in the browser sheet that opens. **4. Turn the connector on in a conversation** Open the **+** menu, select **Connectors**, and switch **SocialAPI** on. ## Try it Ask Claude: ```text theme={null} List my connected social accounts ``` Claude calls `social_api_list_accounts` and answers with your connected accounts and their platforms. Then try "Show me the latest comments on my Instagram posts". ## Troubleshooting > **Connect shows Request instead** > > Your Team plan does not let you enable connectors yourself. Send the request, and an organization admin enables SocialAPI in **Organization settings** → **Connectors**. > **Claude Code does not open a browser** > > Claude Code uses your system default browser. Set one, or run `claude mcp login socialapi --no-browser` and open the authorization URL that Claude Code prints. > **SocialAPI tools are missing in a conversation** > > Open **+** → **Connectors** and check that **SocialAPI** is on. A conversation does not use a connector that is off. > **Tool calls fail with HTTP 401** > > The OAuth session expired. Remove the SocialAPI connector and add it again to sign in again. ## Related * [SocialAPI MCP server](https://docs.social-api.ai/integrations/overview.md): the server URL and the other supported clients. * [MCP tools reference](https://docs.social-api.ai/integrations/tools.md): every tool Claude can call. * [OAuth for MCP clients](https://docs.social-api.ai/integrations/oauth.md): how the sign-in works. * [Errors](https://docs.social-api.ai/guides/errors.md): every error code a tool can return. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.