Copy page

Integrations

Claude

OmniSocials integrates with every flavor of Claude: claude.ai (web), Claude Desktop, and Claude Code. All three use the same underlying MCP server. The only difference is how you point Claude at it.

claude.ai (remote MCP)

Easiest option. Uses OmniSocials' hosted MCP endpoint, so there is nothing to install locally.

1. Create an API key in OmniSocials (Settings → API)
2. Copy the MCP URL shown next to the key (it looks like https://mcp.omnisocials.com?API_KEY=omsk_live_...)
3. Open Claude Settings → Integrations
4. Click Add custom connector, paste the MCP URL, and save

In any new Claude chat, OmniSocials tools are now available. Ask Claude to list your connected accounts to verify.

Claude Desktop (npm package)

Runs the MCP server locally as a subprocess. Use this if you prefer to keep your API key on-device rather than sending it with every request.

Open claude_desktop_config.json and add:

Code
{
  "mcpServers": {
    "omnisocials": {
      "command": "npx",
      "args": ["-y", "@omnisocials/mcp-server"],
      "env": {
        "OMNISOCIALS_API_KEY": "omsk_live_<YOUR_KEY>"
      }
    }
  }
}

The config file lives at:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Restart Claude Desktop to pick up the new config.

Claude Code (CLI)

One command:

Code
claude mcp add omnisocials -- npx -y @omnisocials/mcp-server

Then export your API key so the MCP subprocess can read it:

Code
export OMNISOCIALS_API_KEY=omsk_live_<YOUR_KEY>

Put the export line in your ~/.zshrc or ~/.bashrc so it persists across shell sessions.

Verifying the connection

In any Claude interface, ask:

Show my connected social accounts on OmniSocials

Claude should call list_accounts and return the accounts in your workspace. If it responds with an authentication or connection error, double-check the API key and restart the client.

Capabilities

With OmniSocials connected, you can ask Claude to:

• List connected accounts, media library items, or scheduled posts
• Create drafts or scheduled posts with per-platform content
• Upload media from a URL and attach to a post
• Query analytics for a post, account, or time period
• Manage webhooks

The full set of tools matches the public API. Your API key's scopes determine what Claude can actually do. A read-only key lets Claude list things but not post.