An MCP (Model Context Protocol) server exposes tools that an AI can call. You can connect any remote MCP server to Moon AI: its tools become available in your conversations, just like a connector’s.
The “MCP servers” tabLink to the The “MCP servers” tab section
“Connectors” › “MCP servers” (chat.realmoon.ai/connectors?tab=mcp) brings together:
| Section | Contents |
|---|---|
| “Your servers” | The servers you added, with “Add an MCP server”. |
| “From your organization” | Servers added by your organization, when you belong to one. |
| “Official servers” | Servers published by the services themselves, ready to connect. |
| “Apps on your computer” | Guides to connect a desktop app, with Moon CLI. |
| “Servers you host” | Guides for servers you run yourself, such as FreeCAD or Archicad. |
Add a serverLink to the Add a server section
- Click “Add an MCP server”.
- Enter a “Name” and the “Server URL”. The address must be public, over
https(orhttp). - Choose the “Authentication”: “Access token” (paste the token provided by the service) or “Sign in (OAuth)” (you are sent to the service’s sign-in page, then brought back here).
- Click “Test connection”. The test lists the tools it found: “Connected, … tools available”.
- Click “Add server”.
The server is tested before it is saved: nothing is kept until it responds. If the server replies that sign-in is required, the form switches to “Sign in (OAuth)” on its own.
Advanced optionsLink to the Advanced options section
| Option | Use |
|---|---|
| “Transport” | “Automatic”, Streamable HTTP or SSE. Leave “Automatic” unless the server requires a specific transport. |
| “Authentication header” | The name of the header to send the token in, if the server does not expect the usual header. |
| “OAuth client ID” and “OAuth client secret” | Only for servers that do not let Moon AI register itself, such as GitHub. |
| “Remove stored token” | Removes the token from a server you already added. |
For a server that requires your own OAuth app, enter this redirect URL in the app:
https://chat.realmoon.ai/api/v1/connectors/mcp/oauth/callbackBlocked addressesLink to the Blocked addresses section
Moon AI blocks local addresses and private networks (localhost, an address on your internal network), credentials written into the address, and responses that are too large. For a server running on your computer, use an HTTPS tunnel protected by a token, as in the Design software guides.
Official serversLink to the Official servers section
The “Official servers” section offers servers published by the services themselves, for example Notion, Linear, Sentry, Atlassian, GitHub, Miro, Webflow, Higgsfield, Unsplash, Gamma, Lucid, Whimsical, Pitch, Cloudinary, Descript and ElevenLabs. Open the card, then “Connect”: you sign in through OAuth with your account on that service.
GitHub does not let Moon AI register itself: create a GitHub OAuth app with the redirect URL above, then paste its client ID and secret in the advanced options.
A server marked “Community project” is not published by the software’s maker. Moon AI does not review its code: only install it if you trust it.
Tool approvalLink to the Tool approval section
Moon AI treats an MCP tool as a write action, so it asks for your approval according to your setting, unless the server declares the tool read-only. The approval setting is the same as for your connectors: see Approve actions.
“Run actions without asking” lets all of the server’s tools run without approval. The server then has the “Trusted” badge. Only turn on this option for a server you control or fully trust.
After an email you received has been read in a conversation, every tool from your MCP servers asks for your approval, even a read-only one, until the end of the conversation.
New toolsLink to the New tools section
When a server adds or changes tools, Moon AI sets them aside: the card shows “… tools to review”. Look them over, then click “Accept these tools” to make them available. A server keeps 40 tools at most.
Manage a serverLink to the Manage a server section
On the server’s card:
- “Edit” changes the name, address or token. A new address requires connecting again;
- “Reconnect” renews an expired OAuth connection (“Reconnect needed”);
- “Pause” and “Resume” turn the server off and back on everywhere;
- “Remove” deletes the server and its settings from Moon AI.
Your organization’s serversLink to the Your organization’s servers section
In a managed organization, admins can add MCP servers for members. They appear under “From your organization”. When one of them requires sign-in, you use your own account; “Sign out” removes your connection without affecting anyone else’s. See Organizations.