{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-@l10n/en/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["native-mcp-clients"]},"type":"markdown"},"seo":{"title":"Native Insyder MCP"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"native-insyder-mcp","__idx":0},"children":["Native Insyder MCP"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Connect your AI assistant to your Insyder workspaces. The native MCP provides ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["all 51 public API operations"]}," as tools: read leads and analytics, update lead details, manage products, record purchases, and create exports, within the permissions you approve."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["This is the MCP for working with your data."]}," The separate ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/en/guides/mcp"},"children":["Documentation MCP"]}," searches these guides and explains the API; it cannot access or change your workspace data. You can connect both, using the names ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Insyder Native"]}," and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Insyder API Docs"]}," to tell them apart."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":""},"children":[]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Native Insyder MCP"},"children":["Native Insyder MCP"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Documentation MCP"},"children":["Documentation MCP"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Use it to"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Read and act on your Insyder data"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Learn how to use Insyder's API and MCP"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Server URL"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://api.insyder.io/mcp"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://docs.insyder.io/mcp"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Authentication"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["OAuth sign-in; API keys also supported"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["None; public documentation"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Workspace access"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Only the workspace and actions you approve"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["None"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Example request"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["“Show my top leads this week.”"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["“Which filters does the leads endpoint accept?”"]}]}]}]}]},{"$$mdtype":"Tag","name":"NativeMCPClients","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"before-you-connect","__idx":1},"children":["Before you connect"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You need an Insyder account with access to a workspace, and permission to add custom connectors in your assistant. Claude's hosted connector and ChatGPT in a browser use ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["OAuth sign-in"]},". The ChatGPT desktop ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Add MCP server"]}," form uses a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["personal Insyder API key"]},". Neither setup needs a local bridge, Node.js installation, or tunnel."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use this server URL:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"https://api.insyder.io/mcp\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For OAuth, sign in with your existing Insyder account when prompted, choose a workspace, and select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Allow access"]},". Read-only access is selected by default. Enable the additional requested actions only if you want the assistant to make changes or create exports. Your assistant receives the data returned by the tools you permit."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"connect-to-claude-desktop","__idx":2},"children":["Connect to Claude Desktop"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use Claude's hosted custom connector. You can add it through your Claude account and use it in Claude Desktop."]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Open ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://claude.ai"},"children":["Claude"]}," and go to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Customize > Connectors > Add custom connector"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Name it ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Insyder Native"]},", enter ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://api.insyder.io/mcp"]},", and select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Continue"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Keep the detected ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Sign in now"]}," and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Use Claude’s published identity"]}," settings, then select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Add"]},". On the connector page, select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Connect"]},". Sign in to Insyder, choose the workspace and permissions, and select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Allow access"]},". No client ID or secret is needed."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Enable ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Insyder Native"]}," in your conversation's ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["+ > Connectors"]}," menu. Ask ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["“Use Insyder Native to list my accessible workspaces.”"]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For Team and Enterprise, an owner first adds the URL under ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Organization settings > Connectors > Add > Custom > Web"]},". Each member then selects ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Connect"]}," to approve their own Insyder access. See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp"},"children":["Claude's custom connector instructions"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If you previously used ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["claude_desktop_config.json"]},", disable that local Insyder entry after verifying this connection so duplicate tools do not appear. The ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#optional-local-api-key-connection"},"children":["optional API-key bridge"]}," remains available for local-only clients."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"connect-to-chatgpt","__idx":3},"children":["Connect to ChatGPT"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"chatgpt-desktop-app","__idx":4},"children":["ChatGPT desktop app"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Follow these steps if your ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Plugins"]}," page has ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Plugins / Apps / MCPs / Skills"]}," tabs. This connection uses an API key. To connect by signing in to Insyder instead, follow ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#chatgpt-in-a-browser-oauth"},"children":["ChatGPT in a browser"]}," below."]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Create an Insyder key."]}," In Insyder, open ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Preferences > API access > Create a key"]},". Set ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Key name"]}," to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ChatGPT"]},", choose ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Read only"]},", and select the workspace you want to use. Select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Save"]},", then ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Copy"]},". The full key is shown only once."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Open the MCP form."]}," In the ChatGPT desktop app, go to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Plugins"]},". Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Add"]}," at the top right, then ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Add MCP server"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/chatgpt-add-mcp-server.ffd14c535191db97bc95dd1432dbe7574840e82abf0e3942427de349e16fdf1f.9c1bb791.png","alt":"ChatGPT Plugins page with the Add menu open and Add MCP server available."},"children":[]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Fill in the connection."]}," On ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Connect to a custom MCP"]},", enter ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Insyder Native"]}," in ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Name"]},", then select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Streamable HTTP"]}," next to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Type"]},". This replaces ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Command to launch"]}," with the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["URL"]}," field. Fill the form exactly as follows:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Field"},"children":["Field"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"What to enter"},"children":["What to enter"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Name"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Insyder Native"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Type"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Streamable HTTP"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["URL"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://api.insyder.io/mcp"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Bearer token env var"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Leave empty"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Headers"]}," — ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Key"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["X-API-Key"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Headers"]}," — ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Value"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Paste the full Insyder key you copied, starting with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["insyder_live_"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Headers from environment variables"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Leave empty"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Paste the key only into ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Headers > Value"]},", without adding ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Bearer"]}," before it. Keep it out of chat messages."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/chatgpt-streamable-http.b912fd4e2c4af470f5afcd4583138ebdff5550e880ad97b14fb425ca8fe09630.9c1bb791.png","alt":"ChatGPT custom MCP form after selecting Streamable HTTP, showing URL, Bearer token env var, Headers, Headers from environment variables, and Save."},"children":[]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Save and restart."]}," Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Save"]}," at the bottom right, then ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Restart"]}," when ChatGPT offers it. In ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Plugins > MCPs"]},", keep ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Insyder Native"]}," enabled."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Try it."]}," Start a new conversation and send:"]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use Insyder Native to list my accessible workspaces."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["ChatGPT should return the workspace you selected for the key. You can now ask it to read leads, products, or analytics. To allow changes or exports later, edit the key's permissions in ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Insyder > Preferences > API access"]},"."]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Insyder currently supports OAuth for hosted ChatGPT connections; the desktop MCP connection above uses the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["X-API-Key"]}," header. For more about the desktop form, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://learn.chatgpt.com/docs/extend/mcp#configure-in-the-chatgpt-desktop-app"},"children":["OpenAI's desktop MCP guide"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"chatgpt-in-a-browser-oauth","__idx":5},"children":["ChatGPT in a browser (OAuth)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use this separate setup at ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://chatgpt.com"},"children":["chatgpt.com"]}," to connect with your Insyder sign-in."]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Open ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Settings > Security and login"]}," and turn on ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Developer mode"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Open ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://chatgpt.com/plugins"},"children":["ChatGPT Plugins"]}," and select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["+"]}," to add an MCP connection."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Enter ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Name"]},": ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Insyder Native"]},", ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Description"]},": ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Read and manage my Insyder workspace data"]},", and the public URL ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://api.insyder.io/mcp"]}," under ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Connection"]},". If authentication options appear, select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["OAuth"]}," and leave the optional client ID and secret empty."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Create the connection. Sign in to Insyder, choose a workspace, review the permissions, and select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Allow access"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Start a new conversation, add ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Insyder Native"]}," from the tools menu, and ask ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["“Use Insyder Native to list my accessible workspaces.”"]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Developer mode"]}," or ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["+"]}," is unavailable, your account or workspace policy may restrict custom connections. A workspace administrator may need to enable them. See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://developers.openai.com/plugins/deploy/connect-chatgpt#test-an-mcp-server-optional"},"children":["OpenAI's browser MCP instructions"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"connect-another-mcp-client","__idx":6},"children":["Connect another MCP client"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Clients with custom HTTP headers can use a personal API key:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Setting"},"children":["Setting"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Value"},"children":["Value"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Name"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Insyder Native"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Transport"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Streamable HTTP"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Server URL"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://api.insyder.io/mcp"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Header name"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["X-API-Key"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Header value"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Your personal Insyder API key"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Create a key under ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Insyder > Preferences > API access"]},", select its workspaces and permissions, and save it when displayed. Use the client's private secret storage for the header. Never paste credentials into a chat message or put them in the server URL. See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/en/guides/authentication"},"children":["API-key authentication"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["OAuth client onboarding currently supports hosted ChatGPT and Claude. Other clients should use the API-key connection unless their OAuth integration has been enabled by Insyder. Send only one authentication method per request."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The native URL ends in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/mcp"]},", not ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/v1/mcp"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/sse"]},". Authentication applies to tool discovery and calls. The server is stateless and supports legacy MCP clients and the 2026-07-28 protocol; opening the URL in a browser is not a connection test."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"optional-local-api-key-connection","__idx":7},"children":["Optional local API-key connection"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For a client that only accepts local ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["mcpServers"]}," configuration, install ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://nodejs.org/en/download"},"children":["Node.js LTS"]}," and use the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://github.com/punkpeye/mcp-remote"},"children":["mcp-remote bridge"]},". This optional setup runs on your computer. The Claude and ChatGPT setups above do not use it."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"mcpServers\": {\n    \"insyder-native\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"-y\",\n        \"mcp-remote@0.13.5\",\n        \"https://api.insyder.io/mcp\",\n        \"--transport\",\n        \"http-only\",\n        \"--silent\",\n        \"--header\",\n        \"X-API-Key:${INSYDER_API_KEY}\"\n      ],\n      \"env\": {\n        \"INSYDER_API_KEY\": \"YOUR_INSYDER_API_KEY\"\n      }\n    }\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Replace ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["YOUR_INSYDER_API_KEY"]}," with your saved key in the private configuration file; leave ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["${INSYDER_API_KEY}"]}," unchanged. Fully restart the client. Use an absolute ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["npx"]}," path if it is not on the client's PATH. Closing the local bridge stops this connection."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"what-you-can-do","__idx":8},"children":["What you can do"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Try these requests after listing your workspaces:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["“For workspace @mybrand, show 20 uncontacted leads with a score of at least 80.”"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["“Summarize the revenue and lead funnel for @mybrand this month.”"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["“Show the products in @mybrand, including archived products.”"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["“Update this lead's notes to ‘Requested a callback tomorrow’.”"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["“Prepare an export of the leads in @mybrand and retrieve the download link when it is ready.”"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The last two requests require the corresponding write/export scopes. The assistant should use the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["account_id"]}," returned by ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["listAccounts"]},"; a workspace's username is not its API identifier."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"permissions","__idx":9},"children":["Permissions"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Action"},"children":["Action"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Required scope"},"children":["Required scope"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Additional rule"},"children":["Additional rule"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Read data and analytics"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["data:read"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Workspace must be approved on the connection or key"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Edit user-managed lead fields"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["leads:write"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Status, email, phone, and notes only"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Create, edit, or archive products"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["products:write"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["User must be OWNER or ADMIN in the workspace"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Record purchases"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["purchases:write"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Purchases are append-only"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Create exports"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["exports:create"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["data:read"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Download links expire"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The catalogue lists every tool, including tools your connection cannot execute. The API checks permissions on each call. OAuth disconnection, key revocation, expiry, workspace access, and membership changes are checked on each request. MCP uses the same API limits, including the shared per-user rate limit; it does not grant extra access."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Imported data and system-derived facts remain read-only. Neither MCP adds provider credentials, connection management, synchronization controls, analysis triggers, or other operations absent from the public API."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"complete-tool-catalogue","__idx":10},"children":["Complete tool catalogue"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Each tool name matches an ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["operationId"]}," in the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/en/api/openapi"},"children":["API reference"]},", with the same parameters and responses."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Capability"},"children":["Capability"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Tools"},"children":["Tools"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Workspaces"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["listAccounts"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["getAccount"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Leads"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["listLeads"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["getLead"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["updateLead"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["listLeadInteractions"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["getLeadActivity"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["listLeadStatusHistory"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["listLeadScoreHistory"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["listLeadPurchases"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["listLeadIclosedCalls"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Content"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["listContent"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["getContent"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["listContentInteractions"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["listContentLeads"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["listContentSnapshots"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Interactions"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["listInteractions"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Products"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["listProducts"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["getProduct"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["createProduct"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["updateProduct"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["archiveProduct"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Purchases"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["listPurchases"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["getPurchase"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["createPurchase"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["History"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["listRuns"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["listAccountSnapshots"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["listAllContentSnapshots"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["listHighlights"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["getHighlight"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["listHighlightItems"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Imported results"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["listIclosedCalls"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["listCompetitors"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["getCompetitor"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["listCompetitorInteractions"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["getCompetitorContentPerformance"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["listCompetitorReactiveProfiles"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Analytics"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["getAnalyticsOverview"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["getLeadGrowthAnalytics"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["getAudienceSeries"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["getAudienceSegments"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["getFunnelAnalytics"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["getRevenueAnalytics"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["getContentPerformanceAnalytics"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["getCommentBehaviorAnalytics"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["getStoryPerformanceAnalytics"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["getTeamConversionAnalytics"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Exports"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["createExport"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["getExport"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["deleteExport"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"tool-arguments-and-results","__idx":11},"children":["Tool arguments and results"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Most assistants build tool arguments for you. For custom integrations, API path and query parameters become top-level arguments, JSON payloads go inside ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["body"]},", and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Idempotency-Key"]}," becomes ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["idempotency_key"]},". Array filters stay JSON arrays."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Example arguments for ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["listLeads"]},":"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"account_id\": \"WORKSPACE_ID\",\n  \"status\": [\"uncontacted\"],\n  \"min_score\": 80,\n  \"limit\": 20\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Example arguments for ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["updateLead"]},":"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"account_id\": \"WORKSPACE_ID\",\n  \"lead_id\": \"LEAD_ID\",\n  \"body\": { \"notes\": \"Requested a callback tomorrow\" }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Tools return both JSON text and structured content containing the API's status, operational headers, and unchanged response body:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"status\": 200,\n  \"headers\": { \"x-request-id\": \"REQUEST_ID\" },\n  \"body\": {\n    \"data\": [],\n    \"meta\": { \"request_id\": \"REQUEST_ID\", \"has_more\": false, \"next_cursor\": null }\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Pagination:"]}," pass ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["body.meta.next_cursor"]}," as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cursor"]},", keeping the same filters. Collections default to 50 items, with a maximum of 200; smaller pages can be easier for assistants to handle."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Writes:"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["createProduct"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["createPurchase"]},", and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["createExport"]}," require ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["idempotency_key"]},". If a call's outcome is uncertain, retry with the same key and identical body. The API retains idempotency records for 24 hours."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Exports:"]}," call ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["createExport"]},", then poll ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["getExport"]}," until ready. Use the returned temporary download links before they expire. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["deleteExport"]}," cancels/deletes an export."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Errors:"]}," API failures set ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["isError: true"]}," and preserve the API's problem response. Invalid tool arguments are rejected before dispatch. A successful deletion may return status ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["204"]}," with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["body: null"]},"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"troubleshooting","__idx":12},"children":["Troubleshooting"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Symptom"},"children":["Symptom"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"What to check"},"children":["What to check"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Assistant searches docs but cannot list workspaces"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["You connected ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Insyder API Docs"]},". Add ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Insyder Native"]}," using this guide and select it in the conversation."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["ChatGPT desktop shows ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Command to launch"]}," instead of ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["URL"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Streamable HTTP"]}," next to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Type"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["ChatGPT desktop asks to authenticate or returns ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["401"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Check ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Headers"]},": ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Key"]}," must be ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["X-API-Key"]}," and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Value"]}," must contain your full, active Insyder key. Leave ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Bearer token env var"]}," empty, save, and restart ChatGPT."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["OAuth connection fails before sign-in"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://api.insyder.io/mcp"]},", select OAuth, and leave client ID/secret empty. Refresh or recreate an older connection to fetch current authentication metadata."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["“Connection interrupted”"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Restart Connect from your assistant. Allow cookies in the sign-in browser, finish the flow promptly, and use an Insyder account with a verified email and workspace access."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Sign-in appears despite an open Insyder app"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Sign in with the same Insyder account. The browser's connector-login session is separate from the app's existing session."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Connection expired or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["401"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Reconnect the assistant. OAuth connections expire after 90 days or when disconnected. For API-key clients, check key expiry, revocation, and the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["X-API-Key"]}," header."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["403"]}," when calling a tool"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Check the approved scopes and your workspace role. Reconnect and approve the additional actions if you need them."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Workspace/resource returns ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["404"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Check ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["account_id"]},", the selected workspace, and current membership. Inaccessible resources also return ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["404"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Wrong workspace"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Disconnect and reconnect, selecting the workspace you want. Each OAuth connection approves one workspace."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Native endpoint returns ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["404"]}," or gateway “Missing Authentication Token”"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Verify the API host and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/mcp"]}," path. Contact Insyder support if the native backend is unavailable."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["429"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Reduce concurrent calls and follow ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["retry-after"]}," when present. REST and MCP share a per-user data quota. If connecting another assistant fails, disconnect an unused one; up to 20 OAuth connections can be active per user."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No custom-connector/app controls"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Check your assistant plan and organization policy. An administrator may need to enable or add the connector first."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Optional local bridge cannot start"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Check Node.js and the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["npx"]}," executable path, then fully restart the client."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Tool output is too large"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Ask for fewer records or a narrower date range, then paginate. Use exports for bulk data."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"disconnect-or-change-access","__idx":13},"children":["Disconnect or change access"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Insyder > Preferences > API access > Connected assistants"]},", select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Disconnect"]}," next to the connection. This immediately blocks its access to Insyder. You can also remove the connector in Claude or ChatGPT. Other connections and your Insyder login remain active."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To change the workspace or permissions, disconnect and connect again. If you use an API-key client, revoke or edit its key under ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["API access"]},", and update the private client configuration after rotating it."]}]},"headings":[{"value":"Native Insyder MCP","id":"native-insyder-mcp","depth":1},{"value":"Before you connect","id":"before-you-connect","depth":2},{"value":"Connect to Claude Desktop","id":"connect-to-claude-desktop","depth":2},{"value":"Connect to ChatGPT","id":"connect-to-chatgpt","depth":2},{"value":"ChatGPT desktop app","id":"chatgpt-desktop-app","depth":3},{"value":"ChatGPT in a browser (OAuth)","id":"chatgpt-in-a-browser-oauth","depth":3},{"value":"Connect another MCP client","id":"connect-another-mcp-client","depth":2},{"value":"Optional local API-key connection","id":"optional-local-api-key-connection","depth":3},{"value":"What you can do","id":"what-you-can-do","depth":2},{"value":"Permissions","id":"permissions","depth":3},{"value":"Complete tool catalogue","id":"complete-tool-catalogue","depth":3},{"value":"Tool arguments and results","id":"tool-arguments-and-results","depth":2},{"value":"Troubleshooting","id":"troubleshooting","depth":2},{"value":"Disconnect or change access","id":"disconnect-or-change-access","depth":2}],"frontmatter":{"title":"Native MCP — your Insyder data","description":"Connect Claude Desktop, ChatGPT, or another MCP client to your Insyder workspaces with the full capabilities of the public API.","seo":{"title":"Native Insyder MCP"}},"lastModified":"2026-09-17T08:32:22.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/en/guides/native-mcp","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}