Use Grupy in your favorite AI app

Connect Claude

Sign in with your Grupy login. No access key.

Steps

1. Open Claude, then choose Customize → Connectors → Add custom connector.
2. Paste the Grupy address in the URL field.
3. Choose Sign in now.
4. Sign in to Grupy, check the permissions, then approve.

Notes

• On Team and Enterprise plans, an organization Owner adds the connector in Organization settings → Connectors → Add → Custom → Web.
• You cannot change the sign-in setting after you save. Delete the connector, then add it again.

Official Claude docs

Connect ChatGPT

Sign in with your Grupy login. No access key.

Steps

1. Open ChatGPT on the web, then the Plugins page (chatgpt.com/plugins).
2. Press the plus button, then choose Add custom MCP server.
3. Enter the name Grupy, paste the Grupy address, and choose OAuth.
4. Tick the risk statement, then choose Create as a plugin.
5. Sign in to Grupy and approve. Start a new chat, type @, then choose Grupy.

The steps can differ in your version of the app.

Notes

• ChatGPT does not accept an access key. Use Grupy login.
• According to ChatGPT help, custom MCP servers are available on Business and Enterprise/Edu plans. Other plans can differ.
• When the tool list changes, open the connection on the Plugins page, press Refresh, then start a new chat.

Official ChatGPT docs

Connect OpenAI dots

Sign in with your Grupy login. No access key.

Steps

1. Add Grupy to ChatGPT first. Follow the ChatGPT steps and choose OAuth.
2. dots uses the plugins that you already installed in your ChatGPT account.
3. In the Grupy plugin settings, choose Allow read-only tools.
4. Ask dots to read a group summary. It uses Grupy with no extra step.

The steps can differ in your version of the app.

Notes

• dots does not accept an access key. Use Grupy login.
• OpenAI is rolling dots out in stages, so your account can differ.
• dots can use Grupy in a scheduled task while you are away.

Official OpenAI dots docs

Connect Gemini

Sign in with your Grupy login. No access key.

Steps

1. Open gemini.google.com on the web, then Settings → Connected Apps.
2. Choose Custom apps → Add a custom app.
3. Paste the Grupy address, then press Next.
4. Sign in to Grupy, check the permissions, then approve.
5. In a chat, type @ then choose Grupy.

The steps can differ in your version of the app.

Notes

• This feature exists only on the web. Google limits it to personal accounts of people aged 18 and over, in some regions and languages.
• Sign-in on Gemini sometimes stops halfway. If that happens, try again later or use another app.

Official Gemini docs

Connect Grok

Sign in with your Grupy login. No access key.

Steps

1. Open grok.com/connectors.
2. Choose New Connector → Custom.
3. Paste the Grupy address.
4. Sign in to Grupy, check the permissions, then approve.

The steps can differ in your version of the app.

Notes

• On Business and Enterprise plans, an admin sets up the connector first in console.x.ai → Connectors → + Add Connector → Other.

Official Grok docs

Connect Grok Bot

Sign in with your Grupy login. No access key.

Steps

1. Open the MCP server settings in Grok Bot.
2. Add a remote server, then paste the Grupy address.
3. Sign in to Grupy, check the permissions, then approve.
4. Ask Grok Bot to read a summary of your group.

The steps can differ in your version of the app.

Notes

• Grok Bot is a beta app from xAI and Cursor. Menu names can differ from the steps above.
• Grok Bot accepts only remote MCP servers and only works with Grupy login.

Official Grok Bot docs

Connect Microsoft Copilot Studio

Pick one: Grupy login or an access key. Replace GRUPY_KEY with your own key.

Steps

1. In Copilot Studio, open your agent: Tools → Add a tool → New tool.
2. Choose Model Context Protocol.
3. Fill Server name, Server description, and Server URL with the Grupy address.
4. Pick the authentication: API key (Header) or OAuth 2.0 (Dynamic discovery).
5. Press Create, create a new connection, then Add to agent.

Settings

Server URL:       https://mcp.grupy.chat/mcp
Authentication:   API key
Type:             Header
Header name:      Authorization
Header value:     Bearer GRUPY_KEY

Server URL:       https://mcp.grupy.chat/mcp
Authentication:   OAuth 2.0
Type:             Dynamic discovery

Do not keep an access key in a file that you share or push to a repository.

Notes

• The Power Platform data policy (DLP) of your organization also applies to MCP servers.
• Copilot Studio accepts only the Streamable HTTP transport.

Official Microsoft Copilot Studio docs

Connect Mistral Le Chat

Pick one: Grupy login or an access key. Replace GRUPY_KEY with your own key.

Steps

1. Open Connectors, then press + Add Connector.
2. Choose the Custom MCP Connector tab.
3. Fill Connector name (no spaces or special characters, for example Grupy), Server URL, and a description.
4. Press Connect. Sign in to Grupy when asked, or enter an access key as a Bearer token.

The steps can differ in your version of the app.

Settings

Connector name:  Grupy
Server URL:      https://mcp.grupy.chat/mcp
Authentication:  HTTP Bearer token = GRUPY_KEY

Do not keep an access key in a file that you share or push to a repository.

Notes

• A custom MCP connector needs the admin role. On Free, Pro, and Student plans, the account owner is the admin.

Official Mistral Le Chat docs

Connect Perplexity

Sign in with your Grupy login. No access key.

Steps

1. Open Plugins in the Perplexity sidebar (web or the Mac app).
2. Choose Add custom.
3. Choose a remote server, then paste the Grupy address.
4. Sign in to Grupy when asked, then approve.

The steps can differ in your version of the app.

Notes

• An Enterprise admin can turn off custom connectors for members.

Official Perplexity docs

Connect Meta Muse

Pick one: Grupy login or an access key. Replace GRUPY_KEY with your own key.

Steps

1. Open Meta Muse and start a new chat.
2. Send the sentence below. Muse builds a custom connector for Grupy.
3. When Muse asks about an access key or a header, enter the key in the secure credentials prompt. Or sign in on the Grupy login page.
4. Ask Muse to test all tools, then save the connector as a skill.

The steps can differ in your version of the app.

Settings

Create a custom connector for the Grupy remote MCP server at https://mcp.grupy.chat/mcp (Streamable HTTP, Authorization: Bearer header). Test all tools, then save it as a skill.

Notes

• Muse has no field for an MCP address. You ask Muse in the chat.
• Meta Muse is available in some regions, for adults. Meta does not review custom connectors.

Official Meta Muse docs

Connect Slack

Sign in with your Grupy login. No access key.

Steps

1. Open your Slack app: App Settings → MCP Servers.
2. Add a server with the Grupy address and choose dynamic client registration.
3. Make sure the bot scopes of the app include mcp:connect. Or write the same in the app manifest.
4. Install the app, then sign in to Grupy and approve.

The steps can differ in your version of the app.

Notes

• Slackbot reads the Grupy tools as an MCP client. Each tool must answer within 60 seconds.
• One person can use at most 5 active MCP servers.

Official Slack docs

Connect Poke

Pick one: Grupy login or an access key. Replace GRUPY_KEY with your own key.

Steps

1. Press the Add to Poke button below, or open poke.com/integrations/new.
2. Check that Name holds Grupy and MCP Server URL holds the Grupy address.
3. For Grupy login, leave the API Key field empty. For an access key, enter the key in that field.
4. Save. Poke syncs the Grupy tools on its own.

Settings

npx poke@latest mcp add https://mcp.grupy.chat/mcp -n "Grupy" -k "GRUPY_KEY"

Do not keep an access key in a file that you share or push to a repository.

Notes

• A server with a login must be added on the web, not with a terminal command.
• Never put an access key in a link.

Official Poke docs

Connect Manus

Use an access key. Replace GRUPY_KEY with your own key.

Steps

1. Create an access key in Grupy: menu MCP · AI assistants → Create access key.
2. In Manus, open Settings → Integrations → Custom MCP Servers, then choose Add Server.
3. Fill the name, the Grupy address, and the credential like the block below.
4. Test the connection. Manus fetches the list of Grupy tools.

The steps can differ in your version of the app.

Settings

Name:        Grupy
URL:         https://mcp.grupy.chat/mcp
Credential:  Bearer GRUPY_KEY

Do not keep an access key in a file that you share or push to a repository.

Notes

• Manus needs a quick answer from the server. If it is slow, test again a little later.

Official Manus docs

Connect Claude Code

Pick one: Grupy login or an access key. Replace GRUPY_KEY with your own key.

Steps

1. Open a terminal in your project.
2. Run the add-server command below.
3. For Grupy login, run claude mcp login grupy.
4. Sign in to Grupy, check the permissions, then approve.

Settings

claude mcp add --transport http grupy https://mcp.grupy.chat/mcp
claude mcp login grupy

claude mcp add --transport http grupy https://mcp.grupy.chat/mcp \
  --header "Authorization: Bearer GRUPY_KEY"

{
  "mcpServers": {
    "grupy": {
      "type": "http",
      "url": "https://mcp.grupy.chat/mcp",
      "headers": {
        "Authorization": "Bearer GRUPY_KEY"
      }
    }
  }
}

Do not keep an access key in a file that you share or push to a repository.

Notes

• In a JSON file, write type: http. Without type, Claude Code reads the entry as a local server and skips it.
• Use --scope project or an .mcp.json file when your team needs the same setup.

Official Claude Code docs

Connect Cursor

Sign in with your Grupy login. No access key.

Steps

1. Press the Add to Cursor button below. Cursor opens an install dialog.
2. Or copy the settings into ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (one project).
3. When Cursor opens the Grupy sign-in page, sign in and approve.

Settings

{
  "mcpServers": {
    "grupy": {
      "url": "https://mcp.grupy.chat/mcp"
    }
  }
}

Notes

• Use Grupy login in Cursor. An access key in a header is not reliable: Cursor picks the login as soon as the server offers it.

Official Cursor docs

Connect VS Code + Copilot

Pick one: Grupy login or an access key. Replace GRUPY_KEY with your own key.

Steps

1. Press the Add to VS Code button below, then confirm in VS Code.
2. Or create the file .vscode/mcp.json in your project and paste the settings.
3. For an access key, VS Code asks for the key when the server starts. Enter your own key.
4. For Grupy login, sign in and approve when VS Code opens the sign-in page.

Settings

{
  "servers": {
    "grupy": {
      "type": "http",
      "url": "https://mcp.grupy.chat/mcp"
    }
  }
}

{
  "inputs": [
    {
      "type": "promptString",
      "id": "GRUPY_KEY",
      "description": "Grupy access key",
      "password": true
    }
  ],
  "servers": {
    "grupy": {
      "type": "http",
      "url": "https://mcp.grupy.chat/mcp",
      "headers": {
        "Authorization": "Bearer ${input:GRUPY_KEY}"
      }
    }
  }
}

Do not keep an access key in a file that you share or push to a repository.

Notes

• On Copilot Business and Enterprise, an admin must turn on the MCP servers in Copilot policy. It is off by default.
• For VS Code Insiders, use vscode-insiders:mcp/install with the same content.

Official VS Code + Copilot docs

Connect Windsurf

Use an access key. Replace GRUPY_KEY with your own key.

Steps

1. Create an access key in Grupy: menu MCP · AI assistants → Create access key.
2. Open the mcp_config.json file of Cascade (the path is below).
3. Add the grupy entry from the block below.
4. Save, then reload the server list in Cascade.

The steps can differ in your version of the app.

Settings

{
  "mcpServers": {
    "grupy": {
      "serverUrl": "https://mcp.grupy.chat/mcp",
      "headers": {
        "Authorization": "Bearer GRUPY_KEY"
      }
    }
  }
}

Do not keep an access key in a file that you share or push to a repository.

Notes

• Windsurf is now called Devin Desktop. On Windows, the file is at %APPDATA%\devin\mcp_config.json.
• Cascade limits all servers together to 100 tools.

Official Windsurf docs

Connect OpenAI Codex

Use an access key. Replace GRUPY_KEY with your own key.

Steps

1. Create an access key in Grupy: menu MCP · AI assistants → Create access key.
2. Keep the key in the environment variable GRUPY_KEY, then run the add-server command below.
3. Or paste the TOML block into ~/.codex/config.toml.
4. Run codex mcp list to check. Start a new session.

Settings

[mcp_servers.grupy]
url = "https://mcp.grupy.chat/mcp"
bearer_token_env_var = "GRUPY_KEY"

codex mcp add grupy --url https://mcp.grupy.chat/mcp --bearer-token-env-var GRUPY_KEY

Do not keep an access key in a file that you share or push to a repository.

Notes

• Use an access key in Codex. Grupy login (OAuth) can fail in some Codex versions.
• The ChatGPT desktop app, Codex CLI, and IDE extension share the same config.toml.

Official OpenAI Codex docs

Connect Gemini CLI

Pick one: Grupy login or an access key. Replace GRUPY_KEY with your own key.

Steps

1. Run the add-server command in a terminal. By default, Gemini CLI saves it for this project.
2. Or paste the JSON block into ~/.gemini/settings.json.
3. When Gemini CLI asks you to sign in, sign in to Grupy and approve.

Settings

gemini mcp add --transport http grupy https://mcp.grupy.chat/mcp

gemini mcp add --transport http --header "Authorization: Bearer GRUPY_KEY" grupy https://mcp.grupy.chat/mcp

{
  "mcpServers": {
    "grupy": {
      "httpUrl": "https://mcp.grupy.chat/mcp",
      "timeout": 600000
    }
  }
}

Do not keep an access key in a file that you share or push to a repository.

Notes

• Since 18 June 2026, Gemini CLI no longer serves free, AI Pro, and Ultra users. Antigravity CLI replaces it.
• Antigravity CLI reads ~/.gemini/config/mcp_config.json and uses the key serverUrl, not httpUrl.

Official Gemini CLI docs

Connect Muse Code

Pick one: Grupy login or an access key. Replace GRUPY_KEY with your own key.

Steps

1. Open ~/.config/muse/settings.json.
2. Add the grupy server from the block below.
3. For Grupy login, run muse mcp login grupy, then approve in the browser.

Settings

{
  "schema_version": 1,
  "mcp_servers": {
    "grupy": {
      "transport": "streamable_http",
      "url": "https://mcp.grupy.chat/mcp",
      "mode": "optional"
    }
  }
}

muse mcp login grupy

{
  "schema_version": 1,
  "mcp_servers": {
    "grupy": {
      "transport": "streamable_http",
      "url": "https://mcp.grupy.chat/mcp",
      "headers": {
        "Authorization": "Bearer GRUPY_KEY"
      },
      "mode": "optional"
    }
  }
}

Do not keep an access key in a file that you share or push to a repository.

Notes

• The settings.json file must hold schema_version: 1.
• With mode optional, Muse Code keeps running when Grupy fails to start. Mode required stops the run.

Official Muse Code docs

Connect Zed

Pick one: Grupy login or an access key. Replace GRUPY_KEY with your own key.

Steps

1. Open settings.json in Zed.
2. Add the context_servers.grupy entry from the block below.
3. Without a header, Zed opens the Grupy sign-in page. Sign in and approve.

Settings

{
  "context_servers": {
    "grupy": {
      "url": "https://mcp.grupy.chat/mcp"
    }
  }
}

{
  "context_servers": {
    "grupy": {
      "url": "https://mcp.grupy.chat/mcp",
      "headers": {
        "Authorization": "Bearer GRUPY_KEY"
      }
    }
  }
}

Do not keep an access key in a file that you share or push to a repository.

Notes

• When you fill the Authorization header, Zed does not open the sign-in page.
• Zed only uses the tools and prompts of the server.

Official Zed docs

Connect JetBrains AI Assistant

Pick one: Grupy login or an access key. Replace GRUPY_KEY with your own key.

Steps

1. AI Assistant: open the New MCP Server dialog, choose HTTP, then paste the login JSON block.
2. Junie: save the JSON to .junie/mcp/mcp.json (project) or ~/.junie/mcp/mcp.json (all projects).
3. When Junie shows Authorization required, press Authorize and sign in to Grupy.

The steps can differ in your version of the app.

Settings

{
  "mcpServers": {
    "grupy": {
      "url": "https://mcp.grupy.chat/mcp"
    }
  }
}

{
  "mcpServers": {
    "grupy": {
      "url": "https://mcp.grupy.chat/mcp",
      "headers": {
        "Authorization": "Bearer GRUPY_KEY"
      }
    }
  }
}

Do not keep an access key in a file that you share or push to a repository.

Notes

• An admin can install servers for a team and stop members from adding their own.

Official JetBrains AI Assistant docs

Connect Cline

Pick one: Grupy login or an access key. Replace GRUPY_KEY with your own key.

Steps

1. Open the Remote Servers tab in Cline, or edit the cline_mcp_settings.json file.
2. Add the grupy server with type streamableHttp.
3. For Grupy login, sign in and approve when Cline opens the sign-in page.

Settings

{
  "mcpServers": {
    "grupy": {
      "type": "streamableHttp",
      "url": "https://mcp.grupy.chat/mcp",
      "disabled": false,
      "autoApprove": []
    }
  }
}

cline mcp add grupy https://mcp.grupy.chat/mcp --transport http --header "Authorization: Bearer GRUPY_KEY" --yes

Do not keep an access key in a file that you share or push to a repository.

Notes

• Always write type: streamableHttp. Without type, Cline uses the old SSE.
• Grupy login needs Cline v4 or newer. Cline v3 uses a vscode:// return address that Grupy rejects.

Official Cline docs

Connect Kilo Code

Pick one: Grupy login or an access key. Replace GRUPY_KEY with your own key.

Steps

1. Open kilo.jsonc: global in ~/.config/kilo/, or per project in .kilo/.
2. Add the mcp.grupy entry from the block below.
3. For Grupy login, sign in and approve when Kilo opens the sign-in page.

Settings

{
  "mcp": {
    "grupy": {
      "type": "remote",
      "url": "https://mcp.grupy.chat/mcp",
      "enabled": true
    }
  }
}

{
  "mcp": {
    "grupy": {
      "type": "remote",
      "url": "https://mcp.grupy.chat/mcp",
      "headers": {
        "Authorization": "Bearer GRUPY_KEY"
      },
      "oauth": false,
      "enabled": true
    }
  }
}

Do not keep an access key in a file that you share or push to a repository.

Notes

• For an access key, write oauth: false so Kilo does not start a login.
• This guide is for Kilo Code v7.

Official Kilo Code docs

Connect Goose

Pick one: Grupy login or an access key. Replace GRUPY_KEY with your own key.

Steps

1. Press the Add to Goose button below, then confirm in Goose.
2. Or add the extensions.grupy entry to ~/.config/goose/config.yaml.
3. For Grupy login, sign in and approve when Goose opens the sign-in page.

Settings

extensions:
  grupy:
    name: Grupy
    type: streamable_http
    uri: https://mcp.grupy.chat/mcp
    enabled: true
    timeout: 300

extensions:
  grupy:
    name: Grupy
    type: streamable_http
    uri: https://mcp.grupy.chat/mcp
    headers:
      Authorization: Bearer GRUPY_KEY
    enabled: true
    timeout: 300

Do not keep an access key in a file that you share or push to a repository.

Notes

• The button fills only the address. For an access key, use the access key YAML block.

Official Goose docs

Connect Warp

Use an access key. Replace GRUPY_KEY with your own key.

Steps

1. Create an access key in Grupy: menu MCP · AI assistants → Create access key.
2. In Warp, open Settings → Agents → MCP Servers, then press + Add.
3. Choose the JSON mode and paste the block below.
4. Save. The Grupy server shows in the list.

Settings

{
  "mcpServers": {
    "grupy": {
      "url": "https://mcp.grupy.chat/mcp",
      "headers": {
        "Authorization": "Bearer GRUPY_KEY"
      }
    }
  }
}

Do not keep an access key in a file that you share or push to a repository.

Notes

• Warp works only with an access key. Grupy login is not available in Warp.
• Warp also reads servers from ~/.claude.json and the .mcp.json of Claude Code.

Official Warp docs

Connect Kiro

Pick one: Grupy login or an access key. Replace GRUPY_KEY with your own key.

Steps

1. Press the Add to Kiro button below.
2. Or add the entry to ~/.kiro/settings/mcp.json (all projects) or .kiro/settings/mcp.json (one project).
3. For Grupy login, sign in and approve when the browser opens.

Settings

{
  "mcpServers": {
    "grupy": {
      "url": "https://mcp.grupy.chat/mcp",
      "oauthScopes": [
        "grupy:read"
      ]
    }
  }
}

{
  "mcpServers": {
    "grupy": {
      "url": "https://mcp.grupy.chat/mcp",
      "headers": {
        "Authorization": "Bearer GRUPY_KEY"
      }
    }
  }
}

Do not keep an access key in a file that you share or push to a repository.

Notes

• Set oauthScopes to grupy:read so Kiro does not ask for extra permissions.
• Kiro rejects tool names that are not letters, digits, or underscores. Grupy tool names fit.

Official Kiro docs

Connect Amp

Pick one: Grupy login or an access key. Replace GRUPY_KEY with your own key.

Steps

1. Open ~/.config/amp/settings.json, or .amp/settings.json in a project.
2. Add the amp.mcpServers.grupy entry from the block below.
3. For Grupy login, use the login block. Amp opens a browser to sign in.

Settings

{
  "amp.mcpServers": {
    "grupy": {
      "url": "https://mcp.grupy.chat/mcp"
    }
  }
}

{
  "amp.mcpServers": {
    "grupy": {
      "url": "https://mcp.grupy.chat/mcp",
      "headers": {
        "Authorization": "Bearer GRUPY_KEY"
      }
    }
  }
}

Do not keep an access key in a file that you share or push to a repository.

Notes

• A server in .amp/settings.json needs explicit approval in Amp.

Official Amp docs

Connect opencode

Pick one: Grupy login or an access key. Replace GRUPY_KEY with your own key.

Steps

1. Open opencode.json in your project.
2. Add the mcp.grupy entry from the block below.
3. For Grupy login, run opencode mcp auth grupy, then approve.

Settings

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "grupy": {
      "type": "remote",
      "url": "https://mcp.grupy.chat/mcp",
      "enabled": true,
      "oauth": {
        "scope": "grupy:read"
      }
    }
  }
}

opencode mcp auth grupy

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "grupy": {
      "type": "remote",
      "url": "https://mcp.grupy.chat/mcp",
      "oauth": false,
      "headers": {
        "Authorization": "Bearer GRUPY_KEY"
      }
    }
  }
}

Do not keep an access key in a file that you share or push to a repository.

Notes

• For an access key, write oauth: false so opencode does not start a login.

Official opencode docs

Connect Factory Droid

Pick one: Grupy login or an access key. Replace GRUPY_KEY with your own key.

Steps

1. Run the add-server command in a terminal.
2. For Grupy login, sign in and approve when Droid opens the sign-in page.
3. Open /mcp in Droid to see the server status.

The steps can differ in your version of the app.

Settings

droid mcp add grupy https://mcp.grupy.chat/mcp --type http

droid mcp add grupy https://mcp.grupy.chat/mcp --type http --header "Authorization: Bearer GRUPY_KEY"

Do not keep an access key in a file that you share or push to a repository.

Notes

• Never put an access key in a project file that goes to a repository.

Official Factory Droid docs

Connect Augment

Use an access key. Replace GRUPY_KEY with your own key.

Steps

1. Create an access key in Grupy: menu MCP · AI assistants → Create access key.
2. Auggie CLI: run the command below. Extension: press + Add remote MCP, then choose HTTP.
3. Or paste the JSON block into the Auggie settings.json.

Settings

auggie mcp add grupy --transport http --url https://mcp.grupy.chat/mcp --header "Authorization:Bearer GRUPY_KEY"

{
  "mcpServers": {
    "grupy": {
      "type": "http",
      "url": "https://mcp.grupy.chat/mcp",
      "headers": {
        "Authorization": "Bearer GRUPY_KEY"
      }
    }
  }
}

Do not keep an access key in a file that you share or push to a repository.

Notes

• Augment sends all tools to the agent. Turn on MCP Tool Search when the tool list is too long.

Official Augment docs

Connect OpenClaw

Pick one: Grupy login or an access key. Replace GRUPY_KEY with your own key.

Steps

1. Open the OpenClaw settings, section mcp.servers.
2. Add the grupy server with transport "streamable-http".
3. Access key: fill headers like the key block. Grupy login: run the login command.
4. Check with openclaw mcp doctor grupy --probe.

Settings

{
  "mcp": {
    "servers": {
      "grupy": {
        "url": "https://mcp.grupy.chat/mcp",
        "transport": "streamable-http",
        "headers": {
          "Authorization": "Bearer GRUPY_KEY"
        }
      }
    }
  }
}

openclaw mcp set grupy '{"url":"https://mcp.grupy.chat/mcp","transport":"streamable-http","auth":"oauth","oauth":{"scope":"grupy:read"}}'
openclaw mcp login grupy
openclaw mcp doctor grupy --probe

Do not keep an access key in a file that you share or push to a repository.

Notes

• Always write transport: "streamable-http". Without it, OpenClaw uses the old SSE and the connection fails.
• When auth: "oauth" is on, OpenClaw ignores the Authorization header.

Official OpenClaw docs

Connect Hermes Agent

Pick one: Grupy login or an access key. Replace GRUPY_KEY with your own key.

Steps

1. Press the Add to Hermes button below. Hermes Desktop shows a confirmation dialog.
2. Or add the mcp_servers entry to ~/.hermes/config.yaml.
3. For Grupy login, run hermes mcp login grupy, then approve.
4. Test with hermes mcp test grupy. Reload with /reload-mcp.

Settings

mcp_servers:
  grupy:
    url: "https://mcp.grupy.chat/mcp"
    auth: oauth

hermes mcp login grupy
hermes mcp test grupy

mcp_servers:
  grupy:
    url: "https://mcp.grupy.chat/mcp"
    headers:
      Authorization: "Bearer GRUPY_KEY"

Do not keep an access key in a file that you share or push to a repository.

Notes

• Hermes does not overwrite a server name that already exists.
• The login token is kept in ~/.hermes/mcp-tokens, readable only by you.

Official Hermes Agent docs

Connect Letta

Use an access key. Replace GRUPY_KEY with your own key.

Steps

1. Create an access key in Grupy: menu MCP · AI assistants → Create access key.
2. Letta API: register the Grupy server with the Python code below.
3. Letta Agent SDK (Node): use mcpServers with type http, like the second code.
4. Fetch the tool list to check the connection.

Settings

server = client.mcp_servers.create(
    server_name="grupy",
    config={
        "mcp_server_type": "streamable_http",
        "server_url": "https://mcp.grupy.chat/mcp",
        "auth_header": "Authorization",
        "auth_token": "Bearer GRUPY_KEY",
    },
)
tools = client.mcp_servers.list_tools(server.id)

await using session = client.resumeSession("agent-123", {
  mcpServers: {
    grupy: {
      type: "http",
      url: "https://mcp.grupy.chat/mcp",
      headers: { Authorization: "Bearer GRUPY_KEY" },
    },
  },
});

Do not keep an access key in a file that you share or push to a repository.

Notes

• Letta Cloud needs a tool sync. A server without a sync shows 0 tools.

Official Letta docs

Connect Mastra

Use an access key. Replace GRUPY_KEY with your own key.

Steps

1. Create an access key in Grupy: menu MCP · AI assistants → Create access key.
2. Install the latest @mastra/mcp.
3. Paste the code below and replace GRUPY_KEY.
4. Call mcp.listTools() to see the Grupy tools.

Settings

import { MCPClient } from '@mastra/mcp'

const mcp = new MCPClient({
  servers: {
    grupy: {
      url: new URL('https://mcp.grupy.chat/mcp'),
      requestInit: {
        headers: { Authorization: 'Bearer GRUPY_KEY' },
      },
    },
  },
})

const tools = await mcp.listTools()

Do not keep an access key in a file that you share or push to a repository.

Notes

• Grupy login needs extra code in Mastra. Use an access key.

Official Mastra docs

Connect LangChain

Use an access key. Replace GRUPY_KEY with your own key.

Steps

1. Create an access key in Grupy: menu MCP · AI assistants → Create access key.
2. Python: install langchain[mcp] 1.4 or newer, then use the Python code below.
3. JavaScript: install @langchain/mcp-adapters 2.x, then use the second code.
4. LangSmith Fleet: Integrations → + Custom MCP. Fill the URL, choose Static Headers, key Authorization.

Settings

from fastmcp.client import Client
from fastmcp.client.transports import StreamableHttpTransport
from langchain.mcp import MCPAdapter

transport = StreamableHttpTransport(
    "https://mcp.grupy.chat/mcp",
    headers={"Authorization": "Bearer GRUPY_KEY"},
)
adapter = MCPAdapter(Client(transport))

import { MCPAdapter } from "@langchain/mcp-adapters";

const adapter = new MCPAdapter({
  servers: {
    grupy: {
      url: "https://mcp.grupy.chat/mcp",
      headers: { Authorization: "Bearer GRUPY_KEY" },
    },
  },
});
const tools = await adapter.listTools();

Do not keep an access key in a file that you share or push to a repository.

Notes

• The old langchain-mcp-adapters package is archived. Use langchain.mcp or @langchain/mcp-adapters.

Official LangChain docs

Connect OpenAI Agents SDK

Use an access key. Replace GRUPY_KEY with your own key.

Steps

1. Create an access key in Grupy: menu MCP · AI assistants → Create access key.
2. Agents SDK (Python): use MCPServerStreamableHttp like the first code.
3. Responses API: add an mcp tool item like the second block.
4. Use allowed_tools to limit the tools that the model sees.

Settings

from agents.mcp import MCPServerStreamableHttp

async with MCPServerStreamableHttp(
    params={
        "url": "https://mcp.grupy.chat/mcp",
        "headers": {"Authorization": "Bearer GRUPY_KEY"},
        "timeout": 10,
    },
    cache_tools_list=True,
) as server:
    ...

{
  "type": "mcp",
  "server_label": "grupy",
  "server_url": "https://mcp.grupy.chat/mcp",
  "headers": {
    "Authorization": "Bearer GRUPY_KEY"
  },
  "require_approval": "always"
}

Do not keep an access key in a file that you share or push to a repository.

Notes

• The OpenAI API does not run a login. Your app must use an access key.

Official OpenAI Agents SDK docs

Connect Vercel AI SDK

Use an access key. Replace GRUPY_KEY with your own key.

Steps

1. Create an access key in Grupy: menu MCP · AI assistants → Create access key.
2. Install @ai-sdk/mcp. This package needs Node.js 22 or newer.
3. Paste the code below and replace GRUPY_KEY.
4. Pass the tools to generateText or streamText.

Settings

import { createMCPClient } from '@ai-sdk/mcp';

const grupy = await createMCPClient({
  transport: {
    type: 'http',
    url: 'https://mcp.grupy.chat/mcp',
    headers: { Authorization: 'Bearer GRUPY_KEY' },
  },
});

const tools = await grupy.tools();
await grupy.close();

Do not keep an access key in a file that you share or push to a repository.

Notes

• AI SDK rejects all HTTP redirects by default. The Grupy address does not redirect.

Official Vercel AI SDK docs

Connect Cloudflare Agents

Pick one: Grupy login or an access key. Replace GRUPY_KEY with your own key.

Steps

1. Use Agents SDK v0.20.0 or newer.
2. Call this.addMcpServer in your Agent class, like the code below.
3. Access key: fill transport.headers. Grupy login: send the person to authUrl.
4. Sign in to Grupy, check the permissions, then approve.

Settings

import { Agent } from "agents";

export class GrupyAgent extends Agent<Env> {
  async connectGrupy() {
    await this.addMcpServer("grupy", "https://mcp.grupy.chat/mcp", {
      transport: {
        type: "streamable-http",
        headers: { Authorization: "Bearer GRUPY_KEY" },
      },
    });
  }
}

const result = await this.addMcpServer(
  "grupy",
  "https://mcp.grupy.chat/mcp",
  {
    callbackHost: "https://your-worker.example.workers.dev",
    transport: { type: "streamable-http" },
  },
);
if (result.state === "authenticating") {
  return result.authUrl; // send the person to this address
}

Do not keep an access key in a file that you share or push to a repository.

Notes

• The login token is kept in the SQLite of the Durable Object and stays after a restart.

Official Cloudflare Agents docs

Connect CrewAI

Use an access key. Replace GRUPY_KEY with your own key.

Steps

1. Create an access key in Grupy: menu MCP · AI assistants → Create access key.
2. Install mcp with uv add mcp, then use MCPServerHTTP like the code below.
3. CrewAI AMP: add a custom MCP server, choose Authentication Token, and fill it like the second block.

The steps can differ in your version of the app.

Settings

from crewai import Agent
from crewai.mcp import MCPServerHTTP

agent = Agent(
    role="WhatsApp group analyst",
    goal="Summarize group discussions",
    backstory="Uses Grupy data",
    mcps=[
        MCPServerHTTP(
            url="https://mcp.grupy.chat/mcp",
            headers={"Authorization": "Bearer GRUPY_KEY"},
            streamable=True,
            cache_tools_list=True,
        )
    ],
)

Authentication:  Authentication Token
Header Name:     Authorization
Value:           Bearer GRUPY_KEY
Add to:          Header

Do not keep an access key in a file that you share or push to a repository.

Notes

• The import name in your CrewAI version can differ. Check the docs when the import fails.
• The open source version has no login. Use an access key.

Official CrewAI docs

Connect LM Studio

Pick one: Grupy login or an access key. Replace GRUPY_KEY with your own key.

Steps

1. Press the Add to LM Studio button below, then confirm.
2. Or open Program → Install → Edit mcp.json and paste the block below.
3. Save. LM Studio reloads that file on its own.
4. For Grupy login, sign in and approve when LM Studio opens the sign-in page.

Settings

{
  "mcpServers": {
    "grupy": {
      "url": "https://mcp.grupy.chat/mcp"
    }
  }
}

{
  "mcpServers": {
    "grupy": {
      "url": "https://mcp.grupy.chat/mcp",
      "headers": {
        "Authorization": "Bearer GRUPY_KEY"
      }
    }
  }
}

Do not keep an access key in a file that you share or push to a repository.

Notes

• Grupy login needs LM Studio 0.4.10 or newer. Use Chrome or Firefox, not Safari, for the sign-in page.
• Tools only appear on models that support tool use. Each tool call asks for confirmation.

Official LM Studio docs

Connect Jan

Pick one: Grupy login or an access key. Replace GRUPY_KEY with your own key.

Steps

1. Open Settings → MCP Servers. In newer versions, it is called Connectors.
2. Choose Add server by JSON, or fill the form: Transport HTTP and the Grupy URL.
3. Paste the block below and save.
4. Without an Authorization header, Jan opens the Grupy sign-in page. Sign in and approve.

Settings

{
  "mcpServers": {
    "grupy": {
      "type": "http",
      "url": "https://mcp.grupy.chat/mcp",
      "timeout": 30,
      "active": true
    }
  }
}

{
  "mcpServers": {
    "grupy": {
      "type": "http",
      "url": "https://mcp.grupy.chat/mcp",
      "headers": {
        "Authorization": "Bearer GRUPY_KEY"
      },
      "timeout": 30,
      "active": true
    }
  }
}

Do not keep an access key in a file that you share or push to a repository.

Notes

• Jan sets a limit of 30 seconds for each tool call.

Official Jan docs

Connect Cherry Studio

Pick one: Grupy login or an access key. Replace GRUPY_KEY with your own key.

Steps

1. Press the Add to Cherry Studio button below.
2. Or open Settings → MCP → Add and paste the block below.
3. Turn on the Grupy server. Cherry installs it in an off state.
4. For Grupy login, sign in and approve when Cherry opens the sign-in page.

Settings

{
  "mcpServers": {
    "grupy": {
      "type": "streamableHttp",
      "url": "https://mcp.grupy.chat/mcp"
    }
  }
}

{
  "mcpServers": {
    "grupy": {
      "type": "streamableHttp",
      "url": "https://mcp.grupy.chat/mcp",
      "headers": {
        "Authorization": "Bearer GRUPY_KEY"
      }
    }
  }
}

Do not keep an access key in a file that you share or push to a repository.

Notes

• Always write type: streamableHttp. Without type, Cherry Studio uses the old SSE.
• When the Authorization header is filled, Cherry does not open the sign-in page.

Official Cherry Studio docs

Connect Chatbox

Pick one: Grupy login or an access key. Replace GRUPY_KEY with your own key.

Steps

1. Press the Add to Chatbox button below.
2. Or open Settings → MCP → Add Server, choose HTTP, and fill the Grupy URL.
3. For an access key, add the Authorization header in the form. The button fills only the name and address.
4. For Grupy login, leave the header empty, then sign in and approve.

Settings

{
  "id": "grupy",
  "name": "Grupy",
  "enabled": true,
  "protocolMode": "auto",
  "transport": {
    "type": "http",
    "url": "https://mcp.grupy.chat/mcp",
    "headers": {
      "Authorization": "Bearer GRUPY_KEY"
    }
  }
}

Do not keep an access key in a file that you share or push to a repository.

Notes

• Chatbox uses port 1456 on your computer to receive the sign-in result.

Official Chatbox docs

Connect AnythingLLM

Use an access key. Replace GRUPY_KEY with your own key.

Steps

1. Create an access key in Grupy: menu MCP · AI assistants → Create access key.
2. Open Agent Skills in AnythingLLM. The file anythingllm_mcp_servers.json is created in the storage folder.
3. Add the grupy server from the block below.
4. Call @agent. The server starts then.

Settings

{
  "mcpServers": {
    "grupy": {
      "type": "streamable",
      "url": "https://mcp.grupy.chat/mcp",
      "headers": {
        "Authorization": "Bearer GRUPY_KEY"
      },
      "anythingllm": {
        "autoStart": true
      }
    }
  }
}

Do not keep an access key in a file that you share or push to a repository.

Notes

• Always write type: streamable. Without type, AnythingLLM uses the old SSE.
• AnythingLLM only uses tools from the server. It does not use prompts or resources.

Official AnythingLLM docs

Connect Msty

Use an access key. Replace GRUPY_KEY with your own key.

Steps

1. Create an access key in Grupy: menu MCP · AI assistants → Create access key.
2. In Msty Studio, open Toolbox → Add New Tool → HTTP.
3. Fill MCP Server URL with the Grupy address.
4. Fill Headers: Authorization = Bearer GRUPY_KEY, then save.

Settings

Type:             HTTP
MCP Server URL:  https://mcp.grupy.chat/mcp
Headers:          Authorization = Bearer GRUPY_KEY

Do not keep an access key in a file that you share or push to a repository.

Notes

• Msty only supports Streamable HTTP and needs version 2.2.0 or newer.
• Toolbox is limited on the Free plan.

Official Msty docs

Connect Raycast

Pick one: Grupy login or an access key. Replace GRUPY_KEY with your own key.

Steps

1. Run the Install MCP Server command in Raycast.
2. Fill Name, Transport HTTP, and the URL with the Grupy address.
3. Grupy login: choose OAuth Dynamic. Access key: fill HTTP Headers.
4. Save. If you use login, sign in and approve.

The steps can differ in your version of the app.

Settings

Name:          grupy
Transport:     HTTP
URL:           https://mcp.grupy.chat/mcp
HTTP Headers:  Authorization = Bearer GRUPY_KEY

Name:        grupy
Transport:   HTTP
URL:         https://mcp.grupy.chat/mcp
OAuth type:  Dynamic

Do not keep an access key in a file that you share or push to a repository.

Notes

• MCP in Raycast needs Raycast v2 and the Pro plan. Browser login needs v2.0 or newer.
• Raycast approves read tools on its own. Other tools ask for permission.

Official Raycast docs

Connect n8n

Pick one: Grupy login or an access key. Replace GRUPY_KEY with your own key.

Steps

1. Add the MCP Client Tool node and connect it to the AI Agent node.
2. Fill Endpoint with the Grupy address and choose Server Transport HTTP Streamable.
3. Access key: choose Bearer Auth and enter the key. Grupy login: choose MCP OAuth2 with dynamic client registration.
4. Press Connect my account if you use login, then approve.

Settings

Node:              MCP Client Tool (connect it to an AI Agent)
Endpoint:          https://mcp.grupy.chat/mcp
Server Transport:  HTTP Streamable
Authentication:    Bearer Auth
Bearer Token:      GRUPY_KEY
Tools to Include:  All

Node:              MCP Client Tool (connect it to an AI Agent)
Endpoint:          https://mcp.grupy.chat/mcp
Server Transport:  HTTP Streamable
Authentication:    MCP OAuth2
Credential:        Use Dynamic Client Registration = on
Server URL:        https://mcp.grupy.chat/mcp

Do not keep an access key in a file that you share or push to a repository.

Notes

• For an address with a path such as /mcp, login needs n8n 2.8.0 or newer.

Official n8n docs

Connect Make

Pick one: Grupy login or an access key. Replace GRUPY_KEY with your own key.

Steps

1. In a scenario, add the MCP Client module, then choose Create a connection.
2. Enter the name Grupy. Choose + New MCP Server and fill the URL with the Grupy address.
3. Access key: fill the API Key / Access token field. Grupy login: press Save, then sign in when asked.
4. Test with the Call a tool module.

The steps can differ in your version of the app.

Settings

Connection name:        Grupy
MCP Server:             + New MCP Server
URL:                    https://mcp.grupy.chat/mcp
API Key / Access token: GRUPY_KEY

Do not keep an access key in a file that you share or push to a repository.

Notes

• The Make docs do not state the header format of the API Key field. Test first with Call a tool.
• MCP Client in Make is an open beta for all users.

Official Make docs

Connect Dify

Pick one: Grupy login or an access key. Replace GRUPY_KEY with your own key.

Steps

1. Open Integrations → Tools → MCP → Add MCP Server (HTTP).
2. Fill Server URL with the Grupy address, Name with Grupy, and Server Identifier with grupy.
3. Grupy login: keep Dynamic Client Registration on. Access key: turn it off, then fill Custom Headers.
4. Save. If you use login, sign in and approve.

Settings

Server URL:        https://mcp.grupy.chat/mcp
Name:              Grupy
Server Identifier: grupy
Authentication:    Dynamic Client Registration = off
Custom Headers:    Authorization = Bearer GRUPY_KEY

Server URL:        https://mcp.grupy.chat/mcp
Name:              Grupy
Server Identifier: grupy
Authentication:    Dynamic Client Registration = on

Do not keep an access key in a file that you share or push to a repository.

Notes

• An address that ends in /mcp makes Dify use Streamable HTTP right away. Dify 1.6.0 or newer.
• Do not change Server Identifier after use. Older apps lose their tools.

Official Dify docs

Connect Flowise

Use an access key. Replace GRUPY_KEY with your own key.

Steps

1. Create an access key in Grupy: menu MCP · AI assistants → Create access key.
2. In Flowise, create the variable GRUPY_KEY in the Variables menu and fill it with your key.
3. Add the Custom MCP node and paste the block below into MCP Server Config.
4. Press refresh in Available Actions, then choose a Grupy tool.

Settings

{
  "url": "https://mcp.grupy.chat/mcp",
  "headers": {
    "Authorization": "Bearer {{$vars.GRUPY_KEY}}"
  }
}

Do not keep an access key in a file that you share or push to a repository.

Notes

• Flowise cuts a tool description at 1,024 characters and has no login. Use an access key.

Official Flowise docs

Connect Lindy

Use an access key. Replace GRUPY_KEY with your own key.

Steps

1. Create an access key in Grupy: menu MCP · AI assistants → Create access key.
2. In Lindy, open Integrations → + Add → MCP → Connect MCP server.
3. Fill Server URL with the Grupy address and Display name with Grupy.
4. In Advanced, fill Authorization (bearer token) with the access key, then press Connect.

Settings

Server URL:     https://mcp.grupy.chat/mcp
Display name:   Grupy
Authorization:  GRUPY_KEY  (Advanced → bearer token)

Do not keep an access key in a file that you share or push to a repository.

Notes

• Do not use the query parameter option. Grupy only reads the key from the Authorization header.
• After it connects, compare the number of tools in Lindy with the Grupy tool list. Lindy drops tools whose schema it does not support.

Official Lindy docs