Skip to main content

Connect Socialinsider to Claude & ChatGPT (Quick Setup Guide)

A quick setup guide for pulling Socialinsider data into AI chats

Written by Diana Gogolan

This guide shows you how to connect the Socialinsider MCP server to Claude and ChatGPT, so you can pull live Socialinsider analytics into your AI conversations, without installing anything locally.

✅ What you'll need:

  • an active Socialinsider account with API access

The Socialinsider MCP server is already running here:

When you add that URL to a supported client, you’ll be asked to sign in via a secure OAuth 2.0 flow. No API keys, tokens, or environment variables required.


How authentication works

The first time you use Socialinsider inside Claude or ChatGPT, the app will:

  1. Open a Socialinsider login window in your browser

  2. Ask you to approve access

  3. Return you to the app with the connection ready

If you ever get stuck in a loop of login prompts, skip to Troubleshooting.


Connect to Claude

Option 1 - Web

This is the easiest option.

  1. Open claude.ai

  2. Click Customize (from the navigation bar)

3. Go to 'Connectors'

4. Click on the 'plus' icon - 'add custom connector'

6. Click on 'Connect'

7. Complete the Socialinsider login & authorization flow - you will be asked to log in to your Socialinsider account

8. Check if Socialinsider appears now in the 'Connectors' section

You can now start a new conversation and try it 👇

“Show me the engagement rate for our Instagram profile in the project ‘Automotive’ for the last 30 days.”

Option 2 - Claude Desktop

Claude Desktop supports remote MCP servers.

  1. Find your config file:

    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

    • Windows: %APPDATA%\\\\Claude\\\\claude_desktop_config.json

2. Add this block (create the file if it doesn’t exist):

{
"mcpServers": {
"socialinsider": {
"type": "http",
"url": "https://mcp.socialinsider.io/mcp"
}
}
}

3. Save the file and restart Claude Desktop

4. On first use, complete the Socialinsider OAuth login in the browser window

Verify the connection (optional): if Claude Desktop shows the Socialinsider tools, you’re done.

💡Note: If tools don’t show up, make sure you’re on a recent Claude Desktop version (see their release notes).

Option 3 - Claude Code (CLI)

If you use Claude Code in the terminal:

claude mcp add socialinsider https://mcp.socialinsider.io/mcp

On first use, Claude Code opens a browser window for OAuth login. After you authorize, the tools will be available in that project.

To verify the connection:

claude mcp list


Connect to ChatGPT (Desktop app on macOS)

  1. Open ChatGPT

  2. Go to ChatGPT (menu bar) → Settings

  3. Open the Connectors (or MCP Servers) tab

  4. Click Add server → choose Remote (SSE/HTTP)

  5. Enter:

  6. Save and restart ChatGPT if prompted

  7. On first use, complete the Socialinsider OAuth login in the browser window


Prompt Examples

Use natural language - just include the project, profile, and timeframe.

👉 Competitive analysis

“Compare the engagement rate of @netflix and @disneyplus on Instagram for Q1 2025, and tell me which drove more interactions per post.”

👉 Own profile audit

“Get the last 30 days of profile analytics for our Facebook page in project ‘Acme Corp’ and summarize the follower growth trend.”

👉 Top content

“Fetch the last 50 posts from our Instagram account in the ‘Brand’ project for March 2025 and rank them by engagement rate.”

👉 Multi-platform benchmark

“Compare average views per video for the YouTube channels in project ‘Competitors’ over the past 90 days.”

👉 Campaign performance

“Show me posts tagged with the ‘Summer24’ campaign in project ‘Marketing’ for Instagram between June and August 2024.”


Available Tools

Once connected, your assistant can use these Socialinsider tools:

Tool

What it does

socialinsider_get_profiles

Lists tracked profiles (optionally filtered by project)

socialinsider_profile_search

Searches for a profile by URL or handle

socialinsider_add_profile

Starts tracking a new profile (owned or competitor)

socialinsider_delete_profile

Removes a tracked profile and its historical data

socialinsider_get_posts

Fetches posts with per-post metrics (supports pagination + campaigns)

socialinsider_get_profile_data

Returns daily analytics (followers, engagement, reach, impressions)

socialinsider_get_instagram_stories

Fetches Instagram Stories (owned/authorized business accounts only)

socialinsider_get_brands

Lists brand groups inside a project

socialinsider_get_campaigns

Lists campaign tags available in a project


Troubleshooting

“Unauthorized” or repeated login prompts

  • Complete the OAuth flow in the browser window that opens (don’t close it early)

  • Remove the server and add it again to trigger a fresh login

  • Double-check the URL is exactly: https://mcp.socialinsider.io/mcp

Rate limit errors (429)

  • The error message includes how long to wait before retrying

  • Reduce the date range or number of profiles in your request

Response truncated

  • If the response is very long, use pagination (from / size) to fetch smaller batches

“Invalid timezone”

  • Use an IANA timezone format like UTC, America/New_York, Europe/London, Asia/Tokyo


✌️ Support

Did this answer your question?