> For the complete documentation index, see [llms.txt](https://help.meltingspot.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.meltingspot.io/english/manage-spot/integrations/ai-assistants-mcp.md).

# AI assistants (MCP)

Manage your Spot from your AI assistant (Claude, ChatGPT, Mistral Le Chat, Grok, Cursor…).

Connect your AI assistant to your Spot and ask it, in plain language, to look up your members, invite a group to a live or create tags: it acts directly on your Spot.

The connection relies on **MCP** (Model Context Protocol), the open standard that lets AI assistants use external tools. There is no key to copy: you add the MeltingSpot server address to your assistant, then you authorize access from a MeltingSpot page.

{% hint style="warning" %}
The MCP server is disabled by default. To enable it for your Spot, contact your MeltingSpot representative.
{% endhint %}

## Before you start

* You are an **administrator** of the Spot to connect.
* The MCP server is **enabled** for this Spot.
* You are signed in to MeltingSpot in your browser. If your Spot requires Single Sign-On, sign in with its SSO.
* You have the server address, to copy as is:

```
https://mcp.meltingspot.io/mcp
```

{% hint style="info" %}
The `https://` and the final `/mcp` are required: without them, the connection fails.
{% endhint %}

## Connect your assistant

### The simplest way: the MeltingSpot plugin

With Claude, Claude Code or Codex, the MeltingSpot plugin adds the connection already set up, plus instructions that guide your assistant.

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>MeltingSpot plugin and skills</strong></td><td>The MeltingSpot connection and skills, installed in one go.</td><td><a href="https://help.meltingspot.io/english/manage-spot/integrations/ai-assistants-mcp/meltingspot-plugin-and-skills.md">MeltingSpot plugin and skills</a></td></tr></tbody></table>

### Chat assistants

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Claude</strong></td><td>claude.ai and Claude Desktop, with a custom connector.</td><td><a href="https://help.meltingspot.io/english/manage-spot/integrations/ai-assistants-mcp/connect-claude.md">Connect Claude</a></td></tr><tr><td><strong>ChatGPT</strong></td><td>With a custom MCP server, on chatgpt.com.</td><td><a href="https://help.meltingspot.io/english/manage-spot/integrations/ai-assistants-mcp/connect-chatgpt.md">Connect ChatGPT</a></td></tr><tr><td><strong>Mistral Le Chat</strong></td><td>With a custom MCP connector.</td><td><a href="https://help.meltingspot.io/english/manage-spot/integrations/ai-assistants-mcp/connect-mistral-le-chat.md">Connect Mistral Le Chat</a></td></tr><tr><td><strong>Grok</strong></td><td>With a custom connector, on grok.com.</td><td><a href="https://help.meltingspot.io/english/manage-spot/integrations/ai-assistants-mcp/connect-grok.md">Connect Grok</a></td></tr></tbody></table>

### Developer tools

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Cursor</strong></td><td>In the Cursor editor, through the mcp.json file.</td><td><a href="https://help.meltingspot.io/english/manage-spot/integrations/ai-assistants-mcp/connect-cursor.md">Connect Cursor</a></td></tr><tr><td><strong>Claude Code</strong></td><td>In the terminal, with one command.</td><td><a href="https://help.meltingspot.io/english/manage-spot/integrations/ai-assistants-mcp/connect-claude-code.md">Connect Claude Code</a></td></tr><tr><td><strong>OpenAI Codex</strong></td><td>In the desktop app or from the command line.</td><td><a href="https://help.meltingspot.io/english/manage-spot/integrations/ai-assistants-mcp/connect-openai-codex.md">Connect OpenAI Codex</a></td></tr><tr><td><strong>VS Code (GitHub Copilot)</strong></td><td>In Visual Studio Code, with the Copilot chat.</td><td><a href="https://help.meltingspot.io/english/manage-spot/integrations/ai-assistants-mcp/connect-vs-code-github-copilot.md">Connect VS Code (GitHub Copilot)</a></td></tr><tr><td><strong>Google Antigravity</strong></td><td>In Antigravity, through the mcp_config.json file.</td><td><a href="https://help.meltingspot.io/english/manage-spot/integrations/ai-assistants-mcp/connect-google-antigravity.md">Connect Google Antigravity</a></td></tr></tbody></table>

To find out what your assistant can do once connected, see [What your assistant can do](https://help.meltingspot.io/english/manage-spot/integrations/ai-assistants-mcp/what-your-assistant-can-do.md).

## Authorize access to your Spot

When you add MeltingSpot to your assistant, a MeltingSpot page opens in your browser: "*\[your assistant]* wants to access your MeltingSpot account".

1. In **Spot to connect**, pick the Spot.
2. Review what the assistant will be able to do:
   * view the Spot: members, groups, tags, channels, forums and content;
   * update the Spot on your behalf: invite members, edit groups, tags and content;
   * delete on your behalf: groups, tags, channels, forums, topics and lives.
3. Click **Authorize**.

You are taken back to your assistant, ready to go.

{% hint style="info" %}
**One connection = one Spot.** The assistant acts only on the Spot you chose. To work on another Spot, add another connection in your assistant.
{% endhint %}

{% hint style="warning" %}
Under the assistant's name, the page shows **Verified application** followed by its domain, or a warning when MeltingSpot cannot confirm its identity. In that case, only continue if you started the connection yourself from your assistant.
{% endhint %}

## Good to know

* **Actions are made on your behalf.** In the Spot, they show as done by you.
* **No email is sent to invited people unless you ask** your assistant for it.
* **Your rights are checked on every request.** If you are no longer an administrator of the Spot, or if the MCP server is disabled, the assistant can no longer act.
* **The connection expires after 30 days without use.** Simply reconnect from your assistant.
* **To disconnect your assistant, do it from your assistant** (see your assistant's guide). Signing out of MeltingSpot does not end the connection.
* **Deletions are permanent.** Check what your assistant is about to do before you confirm.

## Troubleshooting

<table><thead><tr><th width="280">Problem</th><th>Solution</th></tr></thead><tbody><tr><td>The assistant rejects the address, or the connection fails right after adding it.</td><td>Check the address: it must be exactly <code>https://mcp.meltingspot.io/mcp</code>. Delete the connection and create it again with the right address.</td></tr><tr><td>The MeltingSpot page shows "You are not signed in to MeltingSpot".</td><td>Sign in to MeltingSpot in this browser, then start the connection again from your assistant.</td></tr><tr><td>The MeltingSpot page shows "No Spot can be connected".</td><td>You are not an administrator of any Spot where the MCP server is enabled. If your Spot requires Single Sign-On, sign in with its SSO, then start the connection again. Otherwise, contact your MeltingSpot representative.</td></tr><tr><td>The MeltingSpot page shows "This connection request has expired".</td><td>Start the connection again from your assistant.</td></tr><tr><td>The assistant says the MCP server is not enabled for this Spot.</td><td>Contact your MeltingSpot representative.</td></tr><tr><td>The assistant says you must be an administrator of this Spot.</td><td>Ask an administrator of the Spot to give you the administrator role.</td></tr><tr><td>The assistant says your session no longer gives access to this Spot.</td><td>Reconnect from your assistant. If your Spot requires Single Sign-On, sign in with its SSO first.</td></tr></tbody></table>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.meltingspot.io/english/manage-spot/integrations/ai-assistants-mcp.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
