diff --git a/.optimize-cache.json b/.optimize-cache.json index 02acfb2fc6c..ce5c2842b16 100644 --- a/.optimize-cache.json +++ b/.optimize-cache.json @@ -1474,6 +1474,7 @@ "static/images/docs/mcp/vscode/copilot-chat.png": "62aec2b589202897ee1184e538c2d11639f252b52e63ca28acb874aa3644c993", "static/images/docs/mcp/windsurf/windsurf-add-mcp-server.png": "c105756cdcb0f5a9a4f979da344afd76f8dc1b7bf6a02313a1ff72165d52ce71", "static/images/docs/mcp/windsurf/windsurf-cascade-chat.png": "47bafc3f59803b7f7e8dec2e4c9823f5454e268933efbbd9453e8ae5b66233f3", + "static/images/docs/mcp/zed/zed-agent-chat.png": "2f7f8a3403bc0e7299265a4d012da7dd4dbe3c98b8519be8ce9f1b1cab82fb17", "static/images/docs/mcp/zenflow/zenflow-chat.png": "c4334ccaf33cfdfe707a2592e2010a1832a697e52a0cfd5e5c7377422f538b97", "static/images/docs/messaging/dark/message-overview.png": "cb33e8c956e4281c9f75c78ed97fd7892f6c03f7af757d33805afcfe9375166e", "static/images/docs/messaging/dark/message-status.png": "8b280781835ddf6178f5ad88db9a45933aa25cbe0a71a9f8c5eb196c4cf4cbdc", diff --git a/src/partials/mcp-add-ides-tools.md b/src/partials/mcp-add-ides-tools.md index 20078c6f169..70e2de64de9 100644 --- a/src/partials/mcp-add-ides-tools.md +++ b/src/partials/mcp-add-ides-tools.md @@ -21,6 +21,9 @@ You can add the MCP server to various AI tools and code editors: {% cards_item href="/docs/tooling/ai/agents/vscode" title="VS Code" image="/images/docs/mcp/logos/vscode.svg" %} {% /cards_item %} +{% cards_item href="/docs/tooling/ai/agents/zed" title="Zed" image="/images/docs/mcp/logos/zed.svg" %} +{% /cards_item %} + {% cards_item href="/docs/tooling/ai/agents/opencode" title="OpenCode" image="/images/docs/mcp/logos/opencode.svg" %} {% /cards_item %} @@ -51,6 +54,9 @@ You can add the MCP server to various AI tools and code editors: {% cards_item href="/docs/tooling/ai/agents/vscode" title="VS Code" image="/images/docs/mcp/logos/dark/vscode.svg" %} {% /cards_item %} +{% cards_item href="/docs/tooling/ai/agents/zed" title="Zed" image="/images/docs/mcp/logos/dark/zed.svg" %} +{% /cards_item %} + {% cards_item href="/docs/tooling/ai/agents/opencode" title="OpenCode" image="/images/docs/mcp/logos/dark/opencode.svg" %} {% /cards_item %} diff --git a/src/routes/docs/tooling/ai/+layout.svelte b/src/routes/docs/tooling/ai/+layout.svelte index df9507fae5a..163e7c56a25 100644 --- a/src/routes/docs/tooling/ai/+layout.svelte +++ b/src/routes/docs/tooling/ai/+layout.svelte @@ -65,6 +65,10 @@ label: 'VS Code', href: '/docs/tooling/ai/agents/vscode' }, + { + label: 'Zed', + href: '/docs/tooling/ai/agents/zed' + }, { label: 'OpenCode', href: '/docs/tooling/ai/agents/opencode' diff --git a/src/routes/docs/tooling/ai/+page.markdoc b/src/routes/docs/tooling/ai/+page.markdoc index 64bd235aba1..4662f596bb3 100644 --- a/src/routes/docs/tooling/ai/+page.markdoc +++ b/src/routes/docs/tooling/ai/+page.markdoc @@ -25,6 +25,9 @@ AI-powered IDEs and code editors provide intelligent code completion and context {% cards_item href="/docs/tooling/ai/agents/vscode" title="VS Code" image="/images/docs/mcp/logos/vscode.svg" %} {% /cards_item %} +{% cards_item href="/docs/tooling/ai/agents/zed" title="Zed" image="/images/docs/mcp/logos/zed.svg" %} +{% /cards_item %} + {% cards_item href="/docs/tooling/ai/agents/opencode" title="OpenCode" image="/images/docs/mcp/logos/opencode.svg" %} {% /cards_item %} @@ -49,6 +52,9 @@ AI-powered IDEs and code editors provide intelligent code completion and context {% cards_item href="/docs/tooling/ai/agents/vscode" title="VS Code" image="/images/docs/mcp/logos/dark/vscode.svg" %} {% /cards_item %} +{% cards_item href="/docs/tooling/ai/agents/zed" title="Zed" image="/images/docs/mcp/logos/dark/zed.svg" %} +{% /cards_item %} + {% cards_item href="/docs/tooling/ai/agents/opencode" title="OpenCode" image="/images/docs/mcp/logos/dark/opencode.svg" %} {% /cards_item %} diff --git a/src/routes/docs/tooling/ai/agents/zed/+page.markdoc b/src/routes/docs/tooling/ai/agents/zed/+page.markdoc new file mode 100644 index 00000000000..d5a50cd532a --- /dev/null +++ b/src/routes/docs/tooling/ai/agents/zed/+page.markdoc @@ -0,0 +1,150 @@ +--- +layout: article +title: Zed +description: Learn how you can use Zed with Appwrite by adding Appwrite MCP servers and installing Appwrite skills for AI-assisted development. +--- + +{% section #quick-start-prompts step=1 title="Quick start prompts" %} + +Get started quickly with these pre-built prompts for common Appwrite integrations: + +{% cards %} +{% cards_item href="/docs/tooling/ai/quickstart-prompts/nextjs" title="Next.js" icon="icon-nextjs" %} +{% /cards_item %} +{% cards_item href="/docs/tooling/ai/quickstart-prompts/tanstack-start" title="TanStack Start" icon="web-icon-tanstack" %} +{% /cards_item %} +{% /cards %} + +{% arrow_link href="/docs/tooling/ai/quickstart-prompts" %} +Browse all quick start prompts +{% /arrow_link %} + +{% /section %} + +{% section #step-2 step=2 title="Add MCP servers" %} + +Connect Appwrite MCP servers to Zed for deeper integration with the Appwrite API and documentation. + +Before you begin, ensure you have the following **pre-requisites** installed on your system: + +{% tabs %} +{% tabsitem #api-server-prerequisites title="API server" %} + +[uv](https://docs.astral.sh/uv/getting-started/installation/) must be installed on your system. + +{% /tabsitem %} + +{% tabsitem #docs-server-prerequisites title="Docs server" %} + +No additional prerequisites. The docs server runs as a remote HTTP endpoint. + +{% /tabsitem %} +{% /tabs %} + +In Zed, open the **Command Palette** (press `CMD + Shift + P` on MacOS or `CTRL + Shift + P` on Linux), run the `agent: add context server` action, and choose which MCP server you want to configure: + +{% tabs %} +{% tabsitem #api-only title="API server" %} + +In the **Local** tab, update the JSON configuration to include the API server: + +```json +{ + "appwrite-api": { + "command": "uvx", + "args": [ + "mcp-server-appwrite" + ], + "env": { + "APPWRITE_PROJECT_ID": "your-project-id", + "APPWRITE_API_KEY": "your-api-key", + "APPWRITE_ENDPOINT": "https://.cloud.appwrite.io/v1" + } + } +} + +``` + +**Configuration:** + +- Replace `your-project-id` with your actual Appwrite project ID +- Replace `your-api-key` with your Appwrite API key +- Replace `` with your Appwrite Cloud region (e.g., `nyc`, `fra`) + +{% /tabsitem %} + +{% tabsitem #docs-only title="Docs server" %} + +In the **Remote** tab, update the JSON configuration to include the docs server: + +```json +{ + "appwrite-docs": { + "url": "https://mcp-for-docs.appwrite.io" + } +} + +``` + +{% /tabsitem %} +{% /tabs %} + +Click **Add Server** after adding each configuration. You can also review the configured servers in the **Model Context Protocol (MCP) Servers** section of Zed's Agent settings. + +{% /section %} + +{% section #step-3 step=3 title="Install Appwrite skills" %} + +Install Appwrite skills to give Zed's agent SDK-specific knowledge about Appwrite. + +Run the following command in your project directory: + +```bash +npx skills add appwrite/agent-skills +``` + +When prompted: + +1. Select the Appwrite skills that match the SDKs you use in your project. +2. Select **Zed** as one of the AI tools that should use the installed skills. +3. Choose whether to install the skills at the project level or globally. +4. Select **symlink** as the installation method. + +Zed loads skills from `~/.agents/skills/` for global installs and `/.agents/skills/` for project-local installs. Each skill must be a direct child of the `skills` folder and include a `SKILL.md` file. + +{% /section %} + +{% section #step-4 step=4 title="Test the integration" %} + +Open the Agent panel in Zed and test your MCP integrations. You can try out the following example prompts based on the MCP server you have configured: + +{% tabs %} +{% tabsitem #test-api title="API server" %} + +**Example prompts:** + +- `Create a new user in my Appwrite project` +- `List all databases in my project` +- `Show me the tables in my database` +- `Create a new row in my table` +- `Delete a specific user by ID` + +{% /tabsitem %} + +{% tabsitem #test-docs title="Docs server" %} + +**Example prompts:** + +- `How do I set up real-time subscriptions in Appwrite?` +- `Show me how to authenticate users with OAuth` +- `What are the best practices for database queries?` +- `How do I implement file uploads with Appwrite Storage?` +- `Show me an example of using Appwrite Functions` + +{% /tabsitem %} + +{% /tabs %} + +![Zed Agent using the Appwrite docs MCP](/images/docs/mcp/zed/zed-agent-chat.avif) + +{% /section %} diff --git a/src/routes/docs/tooling/ai/skills/+page.markdoc b/src/routes/docs/tooling/ai/skills/+page.markdoc index c464d0a7cac..4bf613ba2c6 100644 --- a/src/routes/docs/tooling/ai/skills/+page.markdoc +++ b/src/routes/docs/tooling/ai/skills/+page.markdoc @@ -13,6 +13,7 @@ Skills work across all major AI dev tools that support them. They are installed - Cursor - Google Antigravity - OpenCode +- Zed - *and more...* # Benefits {% #benefits %} diff --git a/static/images/docs/mcp/logos/dark/zed.svg b/static/images/docs/mcp/logos/dark/zed.svg new file mode 100644 index 00000000000..2e9501635e7 --- /dev/null +++ b/static/images/docs/mcp/logos/dark/zed.svg @@ -0,0 +1,3 @@ + + + diff --git a/static/images/docs/mcp/logos/zed.svg b/static/images/docs/mcp/logos/zed.svg new file mode 100644 index 00000000000..6d5858bdaac --- /dev/null +++ b/static/images/docs/mcp/logos/zed.svg @@ -0,0 +1,3 @@ + + + diff --git a/static/images/docs/mcp/zed/zed-agent-chat.avif b/static/images/docs/mcp/zed/zed-agent-chat.avif new file mode 100644 index 00000000000..28704ce31b3 Binary files /dev/null and b/static/images/docs/mcp/zed/zed-agent-chat.avif differ