Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions .optimize-cache.json
Original file line number Diff line number Diff line change
Expand Up @@ -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",
Expand Down
6 changes: 6 additions & 0 deletions src/partials/mcp-add-ides-tools.md
Original file line number Diff line number Diff line change
Expand Up @@ -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 %}

Expand Down Expand Up @@ -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 %}

Expand Down
4 changes: 4 additions & 0 deletions src/routes/docs/tooling/ai/+layout.svelte
Original file line number Diff line number Diff line change
Expand Up @@ -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'
Expand Down
6 changes: 6 additions & 0 deletions src/routes/docs/tooling/ai/+page.markdoc
Original file line number Diff line number Diff line change
Expand Up @@ -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 %}

Expand All @@ -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 %}

Expand Down
150 changes: 150 additions & 0 deletions src/routes/docs/tooling/ai/agents/zed/+page.markdoc
Original file line number Diff line number Diff line change
@@ -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:
Comment thread
atharvadeosthale marked this conversation as resolved.

{% 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://<REGION>.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 `<REGION>` 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 `<worktree>/.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 %}
1 change: 1 addition & 0 deletions src/routes/docs/tooling/ai/skills/+page.markdoc
Original file line number Diff line number Diff line change
Expand Up @@ -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 %}
Expand Down
3 changes: 3 additions & 0 deletions static/images/docs/mcp/logos/dark/zed.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
3 changes: 3 additions & 0 deletions static/images/docs/mcp/logos/zed.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added static/images/docs/mcp/zed/zed-agent-chat.avif
Binary file not shown.
Loading