Skip to content
Open Screeb

Connect an AI assistant to the Screeb MCP server

Let Claude, ChatGPT, Cursor or another MCP client read your Screeb data and answer your questions about it, after you sign in and pick an organization.

How-to4 min read, updated Oct 15, 2026

The Screeb MCP server lets an AI assistant such as Claude, ChatGPT or Cursor read your Screeb data and answer questions like “What do users complain about in my NPS survey this month?”. You sign in with your Screeb account and choose the organization the assistant can read.

  • Your Screeb account is a member of the organization you want to connect.
  • Your AI assistant or code editor supports remote MCP servers with OAuth sign-in, such as Claude, ChatGPT, Cursor, Claude Code or Visual Studio Code. A client that only accepts a fixed API token cannot connect.
  • The access is read-only: the assistant cannot change anything in Screeb.
  1. Open your organization, click Settings in its sidebar, then, under AI, click General. The organization settings show to Admins only: as a Member, open the General AI settings page directly.
  2. In the MCP server section, copy the address.
The General AI settings of an organization, with the MCP server section and its address ready to copy

Most accounts use https://mcp.screeb.app/mcp. Accounts on a dedicated Screeb environment have their own address, so always copy the one your admin shows.

  1. Open the connector or MCP settings of your assistant. In Claude, it is Settings, then Connectors, then Add custom connector.
  2. Enter a name, for example Screeb, and the server address. You need no token or API key.
  3. Save, then connect. The assistant opens a Screeb sign-in window.

In a code editor or a command line tool, add the server to its MCP configuration. For Claude Code:

Terminal window
claude mcp add --transport http screeb https://mcp.screeb.app/mcp

For Cursor, in .cursor/mcp.json:

{
"mcpServers": {
"screeb": { "url": "https://mcp.screeb.app/mcp" }
}
}
  1. Sign in with your Screeb account, if you are not signed in already.
  2. On the consent screen, pick an organization in Organization. The access requested is “Read your workspaces and survey data”.
  3. Click Allow. You go back to your assistant, now connected.
The Screeb consent screen, with the organization picker, the read access requested and the Allow button

The assistant can read one organization, and only the workspaces your account can access there. To connect it to another organization, sign in again from the assistant and pick that one.

The server gives your assistant three read-only tools. It picks them on its own as you ask questions.

Tool What it does
list_workspaces Lists the workspaces of the organization that you can access.
search_surveys Finds surveys and messages by name or tag, with their status, response counts and questions.
ask_screeb_ai Asks Screeb AI a question about your data: responses and scores, segments, events, sessions and messages.

When the organization has one workspace, the assistant uses it. With several, name one in your question (“in the Marketing workspace”), say “across all workspaces”, or answer when the assistant asks you to pick. Follow-up questions in the same conversation keep the context of the previous ones.

  1. Click your name at the bottom of the sidebar, then Account.
  2. In Connected applications, find the assistant and the organization it can read.
  3. Click Revoke. The assistant loses access within an hour at most, and must go through sign-in again to reconnect.
The Connected applications section of the account settings, with one assistant, its organization and a Revoke button

Access is granted per organization: revoking one organization leaves the others connected.

Your assistant answers with figures and summaries computed from your Screeb data, without exports or dashboards. Each assistant you connect shows in your account settings, where you can remove it at any time.

The assistant cannot connect. Check the address against the MCP server section of your admin, and that your assistant supports OAuth sign-in for remote MCP servers.

The consent screen says “Authorization failed”. The sign-in request expires after 10 minutes. Start the connection again from your assistant.

Your organization is not in the list. Your account is not a member of it. Ask an admin of that organization to invite you.

The assistant asks which workspace to use. Name the workspace in your question, or say “across all workspaces”.

The assistant asks you to sign in again. This usually happens after several weeks without use, or after you revoked it. Go through the sign-in and consent again.