> ## Documentation Index
> Fetch the complete documentation index at: https://syncly-a76215af.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect Syncly MCP using a server URL

> Add Syncly as a remote MCP server. Search the Library or analyze data in your Syncly Social workspace.

## Before you start

### Library MCP and Social MCP

| | Library MCP (Syncly Librarian) | Social MCP |
| - | - | - |
| What you can access | Syncly’s library of historical social posts and product reviews, including reviews from Amazon and Sephora. | Posts and analytics from your Syncly Social workspace, including the Queries your team tracks. |
| What you need | A Syncly account. Library MCP uses credits, and you can start free without a workspace. If you need more credits, [contact the Syncly team](https://syncly.app/demo). | An active Syncly Social workspace and subscription, plus a Syncly account with Viewer access or higher in that workspace. |
| When to use it | Research a beauty, food, or beverage trend and find the posts behind it. | Track brand mentions, investigate a spike, or compare competitors in your workspace. |

Both use the same Syncly server address. The tools you see depend on your Syncly account access. For a manual setup, your client needs to support remote MCP and OAuth sign-in.

```text theme={null}
https://mcp.syncly.app/mcp
```

## Connect

For directory setup, see the guides for [Claude](https://syncly-a76215af.mintlify.site/en/start/connect-mcp-claude.md) and [ChatGPT (Codex)](https://syncly-a76215af.mintlify.site/en/start/connect-mcp-codex.md).

1. In your AI client, open the settings for adding a remote MCP server or custom connector.
2. Name it `Syncly` and paste the server URL above. Choose **Streamable HTTP** and **OAuth** if your client asks for them.
3. Sign in to Syncly in your browser, review the requested access, and select **Approve**.
4. Return to your client and start a new chat. Enable the Syncly connector if your client asks you to choose which tools to use.

Enter your Syncly credentials only on the Syncly sign-in page.

> [!NOTE]
>
> **Using ChatGPT or Claude?** Open [Syncly Social in the ChatGPT and Codex directory](https://chatgpt.com/plugins/plugin_asdk_app_6a547b24c764819181ca4fefaafce08c) or [Syncly Social in Claude](https://claude.ai/directory/connectors/syncly) and follow the prompts to sign in to Syncly.

## Ask your first question

To check Library MCP, try asking for source posts about a topic.

```text theme={null}
Use Library MCP to find five posts about protein coffee from the past three months. Summarize what people liked and link to the original posts.
```

### Ask about the right workspace

With Social MCP, one connection covers the workspaces your Syncly account can access. Your role in each workspace determines what you can see. To check the connection, try this prompt.

```text theme={null}
Check which Syncly workspaces I can access and help me choose one to analyze.
```

Then give the workspace name, Query names, date range, and what you want to find out. Changes to your workspace membership or role apply right away.

## Review and disconnect apps

In Syncly, open **Settings > My account > Connected Apps** to see your connections. If you connect the same tool on more than one device, each one appears separately. Disconnect any you no longer use.

![Settings > My account > Connected Apps](https://mintcdn.com/syncly-a76215af/QEimXw3r-PxmgTto/images/connected_apps.png?fit=max\&auto=format\&n=QEimXw3r-PxmgTto\&q=85\&s=5a973290d429eb4ff63df01bc6042203)

> [!WARNING]
>
> Disconnecting an app stops it from getting data right away, even in an open chat. You can have up to 10 active connections. When you add an 11th, the one you've used least recently is disconnected automatically.

## Troubleshoot

* **Syncly tools are missing.** Check that you’re signed in with the right Syncly account, then look under **Connected Apps**. Check that your AI client has enabled the connection for this chat.
* **Social MCP shows the wrong workspace.** Check your Syncly account and name the workspace in your question.
* **A connection stopped working.** Check whether it was disconnected or replaced after you reached the 10-connection limit. If needed, reconnect with the server address above.

Next, [explore and compare queries in Query explorer](https://syncly-a76215af.mintlify.site/en/queries/query-explorer.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.