Connect Simplesat to an AI assistant like Claude or ChatGPT and ask questions about your customer feedback in plain language. Instead of clicking through dashboards and filters, you can just ask — "What was our NPS last quarter?" or "Show me the negative feedback about onboarding" — and get an answer pulled straight from your own Simplesat data.

This works through MCP (Model Context Protocol), an open standard that lets AI assistants securely connect to tools and data sources. You connect once by signing in to Simplesat, and your assistant can then read your feedback whenever you ask.

Who can use this?

Any Simplesat user with an AI assistant that supports remote MCP servers, such as Claude or ChatGPT. You sign in with your normal Simplesat login — no API key needed.

Your assistant sees the same feedback you can see when you log in to Simplesat — the same workspace, the same surveys, the same role permissions. It can't see other workspaces, and it can't change anything.

What you can ask

Once connected, you can ask your assistant questions about your feedback in natural language. For example:

"What was our CSAT score in Q1?"
"How many responses did we get last month, and what was the breakdown?"
"Show me recent negative feedback tagged Billing."
"Which team members got the most positive feedback this quarter?"
"Summarize the main themes in our detractor comments."

Your assistant reads the matching responses from Simplesat, then summarizes, counts, or analyzes them for you. Because it's connected to other tools too, you can also chain requests — for example, "Pull our Q1 NPS feedback and create a follow-up list of detractors to reach out to."

Choose how to connect

There are two ways to connect. Most people should use the first one.

Sign in with Simplesat (recommended). Paste the Simplesat address into your assistant, sign in, and you're done. Nothing to install, no key to manage, and your assistant only sees what your Simplesat role allows.
Use an API key. For assistants that don't support signing in, for server or automation setups, or if you'd rather manage access with a key. An API key gives workspace-wide read access, and only Admins and Owners can create one.

Connect by signing in to Simplesat

Every assistant uses the same Simplesat address:

https://api.simplesat.io/mcp/

When you add it, your assistant opens a Simplesat sign-in page in your browser. Sign in, choose the workspace you want to connect, and click Allow. That's it — the connection stays active until you remove it.

Claude (claude.ai, Claude Desktop, and Claude Code)

Open Settings → Connectors (on claude.ai or in Claude Desktop).
Click Add custom connector.
Enter Simplesat as the name and https://api.simplesat.io/mcp/ as the URL, then click Add.
Click Connect next to Simplesat. A browser window opens — sign in to Simplesat, choose your workspace, and click Allow.

In Claude Code, run this instead and then type /mcp to sign in:

claude mcp add --transport http simplesat https://api.simplesat.io/mcp/

Expected result: Simplesat shows as connected in Connectors, and Simplesat tools appear under the tools icon in the chat input. Try asking "What was our CSAT score last month?"

ChatGPT

Open Settings → Connectors.
Click Create (you may need to enable Developer mode under Advanced settings first).
Enter Simplesat as the name and https://api.simplesat.io/mcp/ as the MCP server URL. Leave authentication set to OAuth.
Click Create. A browser window opens — sign in to Simplesat, choose your workspace, and click Allow.

Expected result: Simplesat appears in your connectors list. In a new chat, enable the Simplesat connector and try asking "How does our CSAT this month compare to last month?"

Other AI assistants

Any assistant that supports remote MCP servers with OAuth sign-in should work. Add a remote (HTTP) MCP server with the URL https://api.simplesat.io/mcp/, leave the authentication method as OAuth, and sign in to Simplesat when prompted. If your assistant only supports API keys, use the API key method below.

Choosing a workspace

If you belong to more than one Simplesat workspace, the sign-in page asks you to pick one, with the workspace you used most recently listed first. One connection covers one workspace. To ask about a different workspace, add Simplesat again as a second connector and pick the other workspace when you sign in.

Disconnecting

To stop your assistant from reading your feedback, remove the Simplesat connector in the assistant's settings. If you're removed from a Simplesat workspace, any connection to that workspace stops working automatically.

Connect with an API key

Use this method if your assistant doesn't support signing in, if you're setting up a server or automation, or if you'd rather manage access with a key. Unlike signing in, an API key gives read access to the whole workspace regardless of the role of the person using it.

Before you start

You'll need three things:

A Simplesat API key. This is how your assistant authenticates to your account. Only Admins and Owners can create API keys, so if you don't have that role, ask an Admin to generate one for you. Learn how to create one in Where can I find my API key?
Node.js installed on your computer. The Claude Desktop and Codex setups below run through a small helper tool that needs Node.js. Download it free from nodejs.org if you don't have it.
An AI assistant that supports MCP, such as Claude Desktop.

Treat your API key like a password. Anyone with it can read your feedback data, so don't share it or paste it anywhere public.

Claude Desktop

Quit Claude Desktop completely — press Cmd+Q on Mac or choose File → Exit on Windows. Just closing the window isn't enough.
Open the Claude Desktop configuration file in any text editor:
Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Add the Simplesat entry inside the mcpServers section. If the file is empty, paste this whole block:

{
  "mcpServers": {
    "Simplesat MCP": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.simplesat.io/mcp/",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Replace YOUR_API_KEY with your Simplesat API key. Keep the word Bearer and the space in front of your key.
Save the file.
Reopen Claude Desktop.

Expected result: Simplesat appears in Claude's tools list (click the tools icon in the chat input to check). Try asking "What was our CSAT score last month?" — Claude will call Simplesat and answer using your own feedback data.

Codex

Open Codex Settings.
Go to Integrations & MCP.
Add a new MCP server named Simplesat MCP with this configuration:

"Simplesat MCP": {
  "command": "npx",
  "args": [
    "-y",
    "mcp-remote",
    "https://api.simplesat.io/mcp/",
    "--header",
    "Authorization:${AUTH_HEADER}"
  ],
  "env": {
    "AUTH_HEADER": "Bearer YOUR_API_KEY"
  }
}

Replace YOUR_API_KEY with your Simplesat API key. Keep the word Bearer and the space in front of your key.
Save.
Restart Codex.

Expected result: Simplesat shows a connected status in Integrations & MCP. Try asking "How does our CSAT this month compare to last month?" — Codex will call Simplesat and answer using your own feedback data.

Gemini CLI

"Login with Google" no longer works for individual Gemini CLI users — only a paid Gemini API key or a Code Assist Standard/Enterprise license. If you see "This client is no longer supported for Gemini Code Assist for individuals," use Antigravity CLI instead, or authenticate gemini with an API key.

Run this command, replacing YOUR_API_KEY:

gemini mcp add --transport http \
  --header "Authorization: Bearer YOUR_API_KEY" \
  simplesat https://api.simplesat.io/mcp/

Confirm it connected: run gemini, then type /mcp inside the session.

Expected result: Simplesat appears in the tool list. Try asking "Show me negative feedback from last week tagged Billing"

Antigravity CLI

Antigravity CLI (agy) is Google's successor to Gemini CLI for individual accounts. If you already had Gemini CLI set up, Antigravity imports your existing config automatically on install — including any MCP servers, so Simplesat may already be connected.

Open (or create) the global MCP config file:

~/.gemini/config/mcp_config.json

Add the Simplesat entry inside mcpServers. If the file is empty, paste this whole block:

{
  "mcpServers": {
    "Simplesat MCP": {
      "serverUrl": "https://api.simplesat.io/mcp/",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Replace YOUR_API_KEY with your Simplesat API key. Keep the word Bearer and the space in front of your key.
Save the file, then restart Antigravity.
Type /mcp in the prompt panel to open the MCP manager and confirm Simplesat shows as connected.

Expected result: Simplesat appears as an active server in the /mcp panel. Try asking "How has our NPS trended over the last quarter, broken down by month?"

What your assistant can and can't do

It's helpful to know the boundaries so you know what to expect.

Your assistant can:

Read and search the feedback responses in your account.
Filter by things like date range, survey, team member, company, score, tag, topic, sentiment, source, and language.
Count responses and summarize scores (like CSAT, CES, or NPS) for a date range you specify.
Pull a sample of matching responses to quote or analyze.

Your assistant can't:

Change, delete, or create anything in Simplesat — it's read-only.
See any workspace other than the one you connected.
See feedback your Simplesat role can't see, when you connected by signing in. If your role doesn't include feedback access, your assistant will tell you so instead of answering.

Always include a date range when you ask for a score. When you ask for an aggregate like NPS, your assistant will compute it across all matching feedback in the window you give it — and the number will match your dashboard for that same range. If you don't specify a range, it will ask you to pick one rather than guess, so your numbers are always accurate.

Troubleshooting

The sign-in window doesn't open, or the connection fails after signing in

Check that your browser isn't blocking pop-ups for your assistant, then try Connect again.
Make sure you signed in to the Simplesat account that belongs to the workspace you want. If you have several Simplesat logins, sign out of Simplesat in your browser and try again.
Remove the Simplesat connector from your assistant and add it again.
If you see "Connecting AI apps isn't available for your workspaces yet", the sign-in method hasn't been enabled for your account. Use an API key for now or contact support.

Your assistant says your role doesn't include feedback access

When you connect by signing in, your assistant can only see what your Simplesat role can see. Ask an Owner or Admin to give your role feedback access, or to add survey access to your custom role.

Your assistant says the rate limit was exceeded

Your workspace made too many requests in one minute. Wait a minute and ask again. If this happens often, contact support.

Your API key isn't accepted

Double-check that your API key was pasted correctly, with no extra spaces, and that Bearer (with a space after it) comes before the key.
Confirm the MCP address is exactly https://api.simplesat.io/mcp/.
Make sure the API key still exists in Simplesat — a deleted key stops working immediately.

Simplesat doesn't appear as an available tool

Fully quit and reopen your assistant. Claude Desktop and Codex only load new connections on a full restart.
If you used an API key with a config file, check that the file is valid JSON — a missing comma or bracket will stop it from loading. Paste it into a JSON checker if you're not sure.
If you used an API key with Claude Desktop or Codex, confirm Node.js is installed by running npx -v in your terminal. If that fails, install Node.js from nodejs.org.

A score doesn't match your dashboard

Make sure you asked for the same date range in both places. The most common cause of a mismatch is a different (or missing) date range.
Check that you're applying the same filters — for example, the same survey or team member.

FAQs

Should I sign in or use an API key?

Sign in. It's quicker, needs nothing installed, and your assistant only sees what you can see. Use an API key only if your assistant can't sign in, or you're setting up a server or automation that runs without you.

Is my feedback data safe?

Yes. The connection is read-only. When you sign in, it's scoped to your own login, your role, and the workspace you chose. When you use an API key, it's scoped to the workspace the key belongs to. Either way, your assistant can't make any changes.

Can I connect more than one workspace?

Yes. Each connection covers one workspace. Add Simplesat as a second connector in your assistant and choose the other workspace when you sign in.

Which AI assistants does this work with?

Claude and ChatGPT support signing in. Claude Desktop, Codex, Gemini CLI, and Antigravity CLI are covered above with an API key. Any assistant that supports remote MCP servers should work with the same address.

Does this cost extra?

No — MCP is included with Simplesat.

Can my assistant change my surveys or responses?

No. The integration is read-only — it can look at your feedback but never edit, delete, or create anything.

I'm an Admin. Can I see who has connected an AI assistant?

Not from the dashboard yet. If you need to know which people have connected, or need a connection turned off, contact support.

What's MCP?

MCP (Model Context Protocol) is an open standard for connecting AI assistants to external tools and data. It's what lets your assistant talk to Simplesat securely.

Still stuck? Reach out to our support team — we're happy to help you get connected.

Simplesat MCP integration