Skip to content

Add remote mcp docs#3095

Open
adityaoberai wants to merge 1 commit into
mainfrom
remote-mcp
Open

Add remote mcp docs#3095
adityaoberai wants to merge 1 commit into
mainfrom
remote-mcp

Conversation

@adityaoberai

Copy link
Copy Markdown
Contributor

What does this PR do?

(Provide a description of what this PR does.)

Test Plan

(Write your test plan here. If you changed any code, please provide us with clear instructions on how you verified your changes work.)

Related PRs and Issues

(If this PR is related to any other PR or resolves any issue or related to any issue link all related PR and issues here.)

Have you read the Contributing Guidelines on issues?

(Write your answer here.)

@appwrite

appwrite Bot commented Jul 10, 2026

Copy link
Copy Markdown

Appwrite Website

Project ID: 69d7efb00023389e8d27

Sites (1)
Site Status Logs Preview QR
 website
69d7f2670014e24571ca
Ready Ready View Logs Preview URL QR Code

Website (appwrite/website)

Project ID: 684969cb000a2f6c0a02

Sites (1)
Site Status Logs Preview QR
 website
68496a17000f03d62013
Processing Processing View Logs Preview URL QR Code


Tip

Messaging handles push notifications, emails, and SMS through one unified API

@adityaoberai adityaoberai marked this pull request as ready for review July 10, 2026 19:02
@greptile-apps

greptile-apps Bot commented Jul 10, 2026

Copy link
Copy Markdown
Contributor

Greptile Summary

This PR migrates all Appwrite MCP documentation from the local uvx/mcp-server-appwrite setup (requiring API keys and a running uv install) to a hosted remote server at https://mcp.appwrite.io/mcp that uses OAuth for authentication. Malformed angle-bracket URLs (e.g. <https://mcp-for-docs.appwrite.io>) that would have rendered broken links are also corrected throughout.

  • Agent pages (Cursor, VS Code, Windsurf, Zed, OpenCode, Codex, Claude Code, Antigravity): removed uv/env-var prerequisite tabs, replaced uvx configs with native remote-URL fields or npx mcp-remote proxies, and added OAuth authentication guidance for each tool.
  • Integration pages (mcp-claude, mcp-cursor, mcp-windsurf): removed the API-key creation step, updated JSON configs to point at the remote server, and added a self-hosted callout linking to the new self-hosted section.
  • MCP API docs page: restructured to lead with remote connection details and OAuth flow, moving the uvx local setup into a dedicated "Self-hosted Appwrite" section.

Confidence Score: 4/5

Documentation-only change; the remote server URL and OAuth flow are consistently applied across the agent pages, and the previously broken angle-bracket URLs are properly fixed.

The three integration pages still use the server key appwrite while every dedicated agent docs page uses appwrite-api, which could leave users with duplicate entries if they follow both sets of docs.

src/routes/integrations/mcp-claude/+page.markdoc, src/routes/integrations/mcp-cursor/+page.markdoc, src/routes/integrations/mcp-windsurf/+page.markdoc — server name should be aligned with the agent docs pages.

Important Files Changed

Filename Overview
src/routes/docs/tooling/ai/agents/antigravity/+page.markdoc Switches API server from local uvx to npx mcp-remote proxy; fixes malformed docs server URL (removed erroneous angle brackets); updates prerequisite text to Node.js/npm only.
src/routes/docs/tooling/ai/agents/claude-code/+page.markdoc Updates CLI commands to use --transport http flag and remote URL for the API server; fixes malformed docs server URL; adds OAuth authentication flow instructions.
src/routes/docs/tooling/ai/agents/codex/+page.markdoc Replaces local uvx-based API server config with codex mcp add --url pointing to the remote server; adds codex mcp login fallback command for OAuth.
src/routes/docs/tooling/ai/agents/cursor/+page.markdoc Replaces uvx command-based config with a url field for the remote API server; simplifies docs server config similarly; removes prerequisite tabs.
src/routes/docs/tooling/ai/agents/opencode/+page.markdoc Switches API server to type remote with url field; renames entry from appwrite to appwrite-api; fixes malformed schema/URL strings throughout.
src/routes/docs/tooling/ai/agents/vscode/+page.markdoc Updates API server config to use url + type http for VS Code MCP JSON format; fixes malformed docs server URL.
src/routes/docs/tooling/ai/agents/windsurf/+page.markdoc Replaces uvx config with serverUrl for the remote API server; fixes malformed docs server URL.
src/routes/docs/tooling/ai/agents/zed/+page.markdoc Switches from Local tab to Remote tab instruction for the API server config; replaces uvx env-based config with a simple url field.
src/routes/docs/tooling/ai/mcp-servers/api/+page.markdoc Major restructure: adds Connection details and self-hosted sections, moves the tool catalog description earlier, and retains the uvx local config only under the new Self-hosted section.
src/routes/docs/tooling/ai/vibe-coding/claude-desktop/+page.markdoc Switches API server from uvx to npx mcp-remote; moves the mcp-remote explanation to the prerequisites; updates error tip from uvx to npx ENOENT.
src/routes/docs/tooling/ai/vibe-coding/emergent/+page.markdoc Replaces uvx API server config with npx mcp-remote proxy; fixes malformed docs server URL.
src/routes/docs/tooling/ai/vibe-coding/zenflow/+page.markdoc Updates API server config to url + type http format for remote server; removes prerequisite tabs and env-var configuration section.
src/routes/integrations/mcp-claude/+page.markdoc Removes API key setup step, switches to OAuth/remote server flow; server is named appwrite here but appwrite-api in the dedicated claude-code agent doc — minor naming inconsistency.
src/routes/integrations/mcp-cursor/+page.markdoc Removes API key step, replaces uvx config with remote URL; server key remains appwrite rather than appwrite-api used in the agent docs page.
src/routes/integrations/mcp-windsurf/+page.markdoc Removes API key step, replaces uvx with serverUrl; server key remains appwrite rather than appwrite-api used in the windsurf agent docs page.

Fix All in Claude Code Fix All in Codex

Prompt To Fix All With AI
Fix the following 1 code review issue. Work through them one at a time, proposing concise fixes.

---

### Issue 1 of 1
src/routes/integrations/mcp-claude/+page.markdoc:59-70
**Inconsistent MCP server name across docs**

The integration pages (`mcp-claude`, `mcp-cursor`, `mcp-windsurf`) register the server under the name `"appwrite"`, while every agent docs page (`claude-code`, `cursor`, `windsurf`, `vscode`, `zed`, etc.) registers it as `"appwrite-api"`. A user who follows both sets of docs ends up with two differently-named entries pointing to the same remote URL. Standardising on a single name (e.g. `"appwrite-api"`) across all pages would prevent that duplication. The same pattern appears in `mcp-cursor/+page.markdoc` and `mcp-windsurf/+page.markdoc`.

Reviews (1): Last reviewed commit: "Add remote mcp docs" | Re-trigger Greptile

Comment on lines 59 to 70
{
"mcpServers": {
"appwrite": {
"command": "uvx",
"command": "npx",
"args": [
"mcp-server-appwrite"
],
"env": {
"APPWRITE_API_KEY": "<your-api-key>",
"APPWRITE_PROJECT_ID": "<your-project-id>",
"APPWRITE_ENDPOINT": "https://<REGION>.cloud.appwrite.io/v1"
}
"mcp-remote",
"https://mcp.appwrite.io/mcp"
]
}
}
}
```

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

P2 Inconsistent MCP server name across docs

The integration pages (mcp-claude, mcp-cursor, mcp-windsurf) register the server under the name "appwrite", while every agent docs page (claude-code, cursor, windsurf, vscode, zed, etc.) registers it as "appwrite-api". A user who follows both sets of docs ends up with two differently-named entries pointing to the same remote URL. Standardising on a single name (e.g. "appwrite-api") across all pages would prevent that duplication. The same pattern appears in mcp-cursor/+page.markdoc and mcp-windsurf/+page.markdoc.

Prompt To Fix With AI
This is a comment left during a code review.
Path: src/routes/integrations/mcp-claude/+page.markdoc
Line: 59-70

Comment:
**Inconsistent MCP server name across docs**

The integration pages (`mcp-claude`, `mcp-cursor`, `mcp-windsurf`) register the server under the name `"appwrite"`, while every agent docs page (`claude-code`, `cursor`, `windsurf`, `vscode`, `zed`, etc.) registers it as `"appwrite-api"`. A user who follows both sets of docs ends up with two differently-named entries pointing to the same remote URL. Standardising on a single name (e.g. `"appwrite-api"`) across all pages would prevent that duplication. The same pattern appears in `mcp-cursor/+page.markdoc` and `mcp-windsurf/+page.markdoc`.

How can I resolve this? If you propose a fix, please make it concise.

Fix in Claude Code Fix in Codex

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.

1 participant