Skip to content

docs: MCP Server known issues and limitations as of 2.4.3 - #3049

Open
salevine wants to merge 3 commits into
mainfrom
docs/mcp-known-issues-2-4-3
Open

salevine wants to merge 3 commits into
mainfrom
docs/mcp-known-issues-2-4-3

Conversation

@salevine

Copy link
Copy Markdown
Contributor

Description

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

  • Adds MCP Server known issues and limitations, a new page under Admin Settings next to the MCP Server (BETA) page, listing the bugs and limitations confirmed as of Appsmith 2.4.3. Each entry gives the symptom the AI client sees, the cause, a status (Bug, fix in progress, Limitation, extension in progress, or By design), and a workaround. It covers JS objects (create returns 400, update never changes code, read returns no source, functions cannot contain logic, free-form JavaScript is never accepted), MongoDB queries (equality-only filters, dates stored as strings, no computed values, find requires the confirm flow), widget properties and events (rejected editor properties, no widget- or query-bound defaults, events cannot call a JS-object function), the tenfold false container-clipping warnings from inspect_page, a short list of limitations that are by design, and how to report a new issue.
  • Links the page from the beta notice on the MCP Server page and adds it to the Admin Settings sidebar directly after that page.
  • Fixes and extensions are attributed to fix(mcp): close the JS-object create/update bugs and authoring gaps from the Banner editor appsmith#42311; the page states they are not in 2.4.3. No internal links, app names, or URLs are included.

Verification: yarn build compiles the site with no broken links (the local post-build search-index step needs the pagefind package, which is unrelated to this change); the built HTML contains the new page and the cross-link.

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.

🤖 Generated with Claude Code

Adds a page under Admin Settings, beside MCP Server (BETA), that lists
the confirmed bugs and limitations of the MCP Server in Appsmith 2.4.3:
JS objects (create returns 400, update never changes code, read returns
no source, functions cannot contain logic), MongoDB queries (equality-
only filters, dates stored as strings, no computed values, find needs
the confirm flow), widget properties and events (rejected editor
properties, no bound defaults, no call into a JS-object function), the
tenfold false container-clipping warnings, the limitations that are by
design, and how to report an issue. Each entry gives the symptom, the
cause, a status and a workaround; fixes are attributed to
appsmithorg/appsmith#42311 and marked as not in 2.4.3.

Links the page from the MCP Server beta notice and the sidebar.

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

vercel Bot commented Sep 29, 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 30, 2026 6:27pm UTC

Request Review

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot review overview

🟡 Changes recommended

The page targets an unpublished version and incorrectly presents a future JS-object capability as currently available.

Review effort: Balanced
Findings: 1 Low severity

Open (1)
What changed in this PR

Adds a reference page for MCP Server bugs and limitations, linked from existing setup documentation and navigation.

Changes:

  • Documents MCP, MongoDB, widget, event, and layout limitations.
  • Adds workarounds and fix statuses.
  • Links and registers the new page.
File Description
website/​sidebars.js Adds the page to Admin Settings navigation.
website/​docs/​getting-started/​setup/​instance-configuration/​mcp-server.mdx Links the known-issues page.
website/​docs/​getting-started/​setup/​instance-configuration/​mcp-server-known-issues.md Adds the detailed limitations reference.

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

sebastianiv21
sebastianiv21 previously approved these changes Sep 30, 2026
Clarified the behavior of editor-authored JavaScript in the known issues section and updated the description to reflect changes after the referenced pull request.

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
sebastianiv21
sebastianiv21 previously approved these changes Sep 30, 2026
…ption key names

Adds an entry for the style and property-pane settings that
patch_widgets cannot set in 2.4.3 (table row selection and styling,
typography, label placement, borders, shadows, date bounds, file-picker
limits, chart axes, image fit) with the extension under review, and
notes that Checkbox, Switch and Radio Group keep their caption in
`label` while `labelText` belongs to Select and MultiSelect.

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

This branch was successfully deployed

1 active deployment
Preview — 996f6d76 Deployed Sep 30, 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.

3 participants