Skip to content

docs: MCP Server multi-replica sessions, hosted-client setup, and approval behavior - #3048

Merged
salevine merged 1 commit into
mainfrom
docs/mcp-hosted-clients-and-replicas
Sep 25, 2026
Merged

salevine merged 1 commit into
mainfrom
docs/mcp-hosted-clients-and-replicas

Conversation

@salevine

Copy link
Copy Markdown
Contributor

Description

Provide a concise summary of the changes made in this pull request

  • Documents the multi-replica behavior of MCP Server: sessions are shared through the Redis that APPSMITH_REDIS_URL names, why sticky sessions cannot help, Redis ACL requirements for a restricted user, and rolling-upgrade behavior. Adds a one-sentence cross-reference under APPSMITH_REDIS_URL on the environment-variables page.
  • Adds client setup tabs for Claude.ai custom connectors (No sign-in + authorization request header) and the ChatGPT desktop app (Plugins → MCPs, available in Codex threads only), and clarifies that the Claude Desktop tab's mcp-remote path is one of two options.
  • Adds a Client compatibility table stating that MCP Server authenticates with the key only and offers no OAuth flow, so ChatGPT conversations and ChatGPT connectors are not supported today.
  • Adds How clients ask for approval, explaining the MCP tool annotations every Appsmith tool now carries (reads and non-destructive edits run without a prompt; confirm_*, branch creation, and commits ask), and how that relates to Appsmith's own prepare/confirm flow.
  • Adds troubleshooting rows for the claude.ai "cannot reach" symptom, the ChatGPT "not exposed to this chat" symptom, the per-call approval symptom on older versions, alternating HTTP 404 on multi-replica instances, and the HTTP 503 relay error.

Depends on appsmithorg/appsmith#42279 (shared sessions through Redis, tool annotations). Merge after that PR ships in a release, or hold until then.

Pull request type

Check the appropriate box:

Documentation tickets

Link to one or more documentation tickets:

  • None. Written alongside the engineering change.

Checklist

From the below options, select the ones that are applicable:

  • Checked for Grammarly suggestions.
  • Adhered to the writing checklist.
  • Adhered to the media checklist.
  • Verified and updated cross-references or added redirect rules.
  • Tested the redirect rules on deploy preview.
  • Validated the modifications made to the content on the deploy preview.
  • Validated the CSS modifications on different screen sizes.

Verified locally: npm run build in website/ succeeds with the new anchors resolved; the client behavior described was reproduced against a deploy preview of #42279 (Codex CLI and the Codex build bundled in the ChatGPT desktop app auto-approve get_capabilities; claude.ai connects with No sign-in + request header; a ChatGPT conversation does not load Plugins → MCPs servers).

🤖 Generated with Claude Code

…roval behavior

Documents the shared MCP session store on multi-replica instances (through
the Redis that APPSMITH_REDIS_URL names; no new setting), adds Claude.ai
and ChatGPT desktop app client tabs, a client compatibility table stating
that MCP Server is key-authenticated with no OAuth flow, a section on how
tool annotations drive client approval prompts, and troubleshooting rows
for the symptoms each of these produces.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
@vercel

vercel Bot commented Sep 25, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
appsmith-docs Ready Ready Preview Sep 25, 2026 1:33am UTC

Request Review

@salevine
salevine merged commit 98ee9fd into main Sep 25, 2026
5 checks passed

This branch was successfully deployed

1 active deployment
Preview — 98501276 Deployed Sep 25, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants