From dd9023a4cf86558985fee477efc44810d17d29dc Mon Sep 17 00:00:00 2001 From: Atharva Deosthale Date: Mon, 18 May 2026 11:18:14 +0530 Subject: [PATCH 1/2] Restructure AI docs: split ai-dev-tools into agentic-coding and vibe-coding, drop legacy /docs/tooling/mcp section --- src/partials/mcp-add-ides-tools.md | 24 +-- src/redirects.json | 64 +++++++- src/routes/(marketing)/(components)/ai.svelte | 12 +- .../(marketing)/(components)/platforms.svelte | 4 +- src/routes/docs/+page.svelte | 8 +- src/routes/docs/tooling/ai/+layout.svelte | 22 +-- src/routes/docs/tooling/ai/+page.markdoc | 44 ++--- .../antigravity/+page.markdoc | 0 .../claude-code/+page.markdoc | 0 .../codex/+page.markdoc | 0 .../cursor/+page.markdoc | 0 .../opencode/+page.markdoc | 0 .../vscode/+page.markdoc | 0 .../windsurf/+page.markdoc | 0 .../tooling/ai/responsible-ai/+page.markdoc | 2 +- .../bolt/+page.markdoc | 0 .../claude-desktop/+page.markdoc | 0 .../emergent/+page.markdoc | 0 .../lovable/+page.markdoc | 0 .../zenflow/+page.markdoc | 0 src/routes/docs/tooling/mcp/+layout.svelte | 78 --------- src/routes/docs/tooling/mcp/+page.markdoc | 41 ----- .../tooling/mcp/antigravity/+page.markdoc | 116 -------------- src/routes/docs/tooling/mcp/api/+page.markdoc | 118 -------------- .../tooling/mcp/claude-code/+page.markdoc | 100 ------------ .../tooling/mcp/claude-desktop/+page.markdoc | 144 ----------------- .../docs/tooling/mcp/cursor/+page.markdoc | 150 ------------------ .../docs/tooling/mcp/docs/+page.markdoc | 72 --------- .../docs/tooling/mcp/opencode/+page.markdoc | 118 -------------- .../docs/tooling/mcp/vscode/+page.markdoc | 121 -------------- .../docs/tooling/mcp/windsurf/+page.markdoc | 123 -------------- .../docs/tooling/mcp/zenflow/+page.markdoc | 120 -------------- 32 files changed, 114 insertions(+), 1367 deletions(-) rename src/routes/docs/tooling/ai/{ai-dev-tools => agentic-coding}/antigravity/+page.markdoc (100%) rename src/routes/docs/tooling/ai/{ai-dev-tools => agentic-coding}/claude-code/+page.markdoc (100%) rename src/routes/docs/tooling/ai/{ai-dev-tools => agentic-coding}/codex/+page.markdoc (100%) rename src/routes/docs/tooling/ai/{ai-dev-tools => agentic-coding}/cursor/+page.markdoc (100%) rename src/routes/docs/tooling/ai/{ai-dev-tools => agentic-coding}/opencode/+page.markdoc (100%) rename src/routes/docs/tooling/ai/{ai-dev-tools => agentic-coding}/vscode/+page.markdoc (100%) rename src/routes/docs/tooling/ai/{ai-dev-tools => agentic-coding}/windsurf/+page.markdoc (100%) rename src/routes/docs/tooling/ai/{ai-dev-tools => vibe-coding}/bolt/+page.markdoc (100%) rename src/routes/docs/tooling/ai/{ai-dev-tools => vibe-coding}/claude-desktop/+page.markdoc (100%) rename src/routes/docs/tooling/ai/{ai-dev-tools => vibe-coding}/emergent/+page.markdoc (100%) rename src/routes/docs/tooling/ai/{ai-dev-tools => vibe-coding}/lovable/+page.markdoc (100%) rename src/routes/docs/tooling/ai/{ai-dev-tools => vibe-coding}/zenflow/+page.markdoc (100%) delete mode 100644 src/routes/docs/tooling/mcp/+layout.svelte delete mode 100644 src/routes/docs/tooling/mcp/+page.markdoc delete mode 100644 src/routes/docs/tooling/mcp/antigravity/+page.markdoc delete mode 100644 src/routes/docs/tooling/mcp/api/+page.markdoc delete mode 100644 src/routes/docs/tooling/mcp/claude-code/+page.markdoc delete mode 100644 src/routes/docs/tooling/mcp/claude-desktop/+page.markdoc delete mode 100644 src/routes/docs/tooling/mcp/cursor/+page.markdoc delete mode 100644 src/routes/docs/tooling/mcp/docs/+page.markdoc delete mode 100644 src/routes/docs/tooling/mcp/opencode/+page.markdoc delete mode 100644 src/routes/docs/tooling/mcp/vscode/+page.markdoc delete mode 100644 src/routes/docs/tooling/mcp/windsurf/+page.markdoc delete mode 100644 src/routes/docs/tooling/mcp/zenflow/+page.markdoc diff --git a/src/partials/mcp-add-ides-tools.md b/src/partials/mcp-add-ides-tools.md index 48ed4d86dae..28d2f5c6067 100644 --- a/src/partials/mcp-add-ides-tools.md +++ b/src/partials/mcp-add-ides-tools.md @@ -3,28 +3,28 @@ You can add the MCP server to various AI tools and code editors: {% only_light %} {% cards %} -{% cards_item href="/docs/tooling/ai/ai-dev-tools/claude-code" title="Claude Code" image="/images/docs/mcp/logos/claude.svg" %} +{% cards_item href="/docs/tooling/ai/agentic-coding/claude-code" title="Claude Code" image="/images/docs/mcp/logos/claude.svg" %} {% /cards_item %} -{% cards_item href="/docs/tooling/ai/ai-dev-tools/codex" title="Codex" image="/images/docs/mcp/logos/openai.svg" %} +{% cards_item href="/docs/tooling/ai/agentic-coding/codex" title="Codex" image="/images/docs/mcp/logos/openai.svg" %} {% /cards_item %} {% cards_item href="/docs/tooling/mcp/cursor" title="Cursor" image="/images/docs/mcp/logos/cursor-ai.svg" %} {% /cards_item %} -{% cards_item href="/docs/tooling/ai/ai-dev-tools/claude-desktop" title="Claude Desktop" image="/images/docs/mcp/logos/claude.svg" %} +{% cards_item href="/docs/tooling/ai/vibe-coding/claude-desktop" title="Claude Desktop" image="/images/docs/mcp/logos/claude.svg" %} {% /cards_item %} {% cards_item href="/docs/tooling/mcp/zenflow" title="Zenflow" image="/images/docs/mcp/logos/zenflow.svg" %} {% /cards_item %} -{% cards_item href="/docs/tooling/ai/ai-dev-tools/vscode" title="VS Code" image="/images/docs/mcp/logos/vscode.svg" %} +{% cards_item href="/docs/tooling/ai/agentic-coding/vscode" title="VS Code" image="/images/docs/mcp/logos/vscode.svg" %} {% /cards_item %} -{% cards_item href="/docs/tooling/ai/ai-dev-tools/opencode" title="OpenCode" image="/images/docs/mcp/logos/opencode.svg" %} +{% cards_item href="/docs/tooling/ai/agentic-coding/opencode" title="OpenCode" image="/images/docs/mcp/logos/opencode.svg" %} {% /cards_item %} -{% cards_item href="/docs/tooling/ai/ai-dev-tools/antigravity" title="Google Antigravity" image="/images/docs/mcp/logos/google-antigravity.svg" %} +{% cards_item href="/docs/tooling/ai/agentic-coding/antigravity" title="Google Antigravity" image="/images/docs/mcp/logos/google-antigravity.svg" %} {% /cards_item %} {% /cards %} @@ -33,28 +33,28 @@ You can add the MCP server to various AI tools and code editors: {% only_dark %} {% cards %} -{% cards_item href="/docs/tooling/ai/ai-dev-tools/claude-code" title="Claude Code" image="/images/docs/mcp/logos/dark/claude.svg" %} +{% cards_item href="/docs/tooling/ai/agentic-coding/claude-code" title="Claude Code" image="/images/docs/mcp/logos/dark/claude.svg" %} {% /cards_item %} -{% cards_item href="/docs/tooling/ai/ai-dev-tools/codex" title="Codex" image="/images/docs/mcp/logos/dark/openai.svg" %} +{% cards_item href="/docs/tooling/ai/agentic-coding/codex" title="Codex" image="/images/docs/mcp/logos/dark/openai.svg" %} {% /cards_item %} {% cards_item href="/docs/tooling/mcp/cursor" title="Cursor" image="/images/docs/mcp/logos/dark/cursor-ai.svg" %} {% /cards_item %} -{% cards_item href="/docs/tooling/ai/ai-dev-tools/claude-desktop" title="Claude Desktop" image="/images/docs/mcp/logos/dark/claude.svg" %} +{% cards_item href="/docs/tooling/ai/vibe-coding/claude-desktop" title="Claude Desktop" image="/images/docs/mcp/logos/dark/claude.svg" %} {% /cards_item %} {% cards_item href="/docs/tooling/mcp/zenflow" title="Zenflow" image="/images/docs/mcp/logos/dark/zenflow.svg" %} {% /cards_item %} -{% cards_item href="/docs/tooling/ai/ai-dev-tools/vscode" title="VS Code" image="/images/docs/mcp/logos/dark/vscode.svg" %} +{% cards_item href="/docs/tooling/ai/agentic-coding/vscode" title="VS Code" image="/images/docs/mcp/logos/dark/vscode.svg" %} {% /cards_item %} -{% cards_item href="/docs/tooling/ai/ai-dev-tools/opencode" title="OpenCode" image="/images/docs/mcp/logos/dark/opencode.svg" %} +{% cards_item href="/docs/tooling/ai/agentic-coding/opencode" title="OpenCode" image="/images/docs/mcp/logos/dark/opencode.svg" %} {% /cards_item %} -{% cards_item href="/docs/tooling/ai/ai-dev-tools/antigravity" title="Google Antigravity" image="/images/docs/mcp/logos/dark/google-antigravity.svg" %} +{% cards_item href="/docs/tooling/ai/agentic-coding/antigravity" title="Google Antigravity" image="/images/docs/mcp/logos/dark/google-antigravity.svg" %} {% /cards_item %} {% /cards %} diff --git a/src/redirects.json b/src/redirects.json index 85d37658dec..d4438f1f1e3 100644 --- a/src/redirects.json +++ b/src/redirects.json @@ -782,31 +782,31 @@ }, { "link": "/docs/tooling/mcp/cursor", - "redirect": "/docs/tooling/ai/ai-dev-tools/cursor" + "redirect": "/docs/tooling/ai/agentic-coding/cursor" }, { "link": "/docs/tooling/mcp/vscode", - "redirect": "/docs/tooling/ai/ai-dev-tools/vscode" + "redirect": "/docs/tooling/ai/agentic-coding/vscode" }, { "link": "/docs/tooling/mcp/windsurf", - "redirect": "/docs/tooling/ai/ai-dev-tools/windsurf" + "redirect": "/docs/tooling/ai/agentic-coding/windsurf" }, { "link": "/docs/tooling/mcp/opencode", - "redirect": "/docs/tooling/ai/ai-dev-tools/opencode" + "redirect": "/docs/tooling/ai/agentic-coding/opencode" }, { "link": "/docs/tooling/mcp/antigravity", - "redirect": "/docs/tooling/ai/ai-dev-tools/antigravity" + "redirect": "/docs/tooling/ai/agentic-coding/antigravity" }, { "link": "/docs/tooling/mcp/claude-code", - "redirect": "/docs/tooling/ai/ai-dev-tools/claude-code" + "redirect": "/docs/tooling/ai/agentic-coding/claude-code" }, { "link": "/docs/tooling/mcp/claude-desktop", - "redirect": "/docs/tooling/ai/ai-dev-tools/claude-desktop" + "redirect": "/docs/tooling/ai/vibe-coding/claude-desktop" }, { "link": "/docs/tooling/mcp/api", @@ -830,12 +830,60 @@ }, { "link": "/docs/tooling/mcp/zenflow", - "redirect": "/docs/tooling/ai/ai-dev-tools/zenflow" + "redirect": "/docs/tooling/ai/vibe-coding/zenflow" }, { "link": "/docs/tooling/ai/ai-dev-tools", "redirect": "/docs/tooling/ai/" }, + { + "link": "/docs/tooling/ai/ai-dev-tools/claude-code", + "redirect": "/docs/tooling/ai/agentic-coding/claude-code" + }, + { + "link": "/docs/tooling/ai/ai-dev-tools/codex", + "redirect": "/docs/tooling/ai/agentic-coding/codex" + }, + { + "link": "/docs/tooling/ai/ai-dev-tools/cursor", + "redirect": "/docs/tooling/ai/agentic-coding/cursor" + }, + { + "link": "/docs/tooling/ai/ai-dev-tools/vscode", + "redirect": "/docs/tooling/ai/agentic-coding/vscode" + }, + { + "link": "/docs/tooling/ai/ai-dev-tools/opencode", + "redirect": "/docs/tooling/ai/agentic-coding/opencode" + }, + { + "link": "/docs/tooling/ai/ai-dev-tools/antigravity", + "redirect": "/docs/tooling/ai/agentic-coding/antigravity" + }, + { + "link": "/docs/tooling/ai/ai-dev-tools/windsurf", + "redirect": "/docs/tooling/ai/agentic-coding/windsurf" + }, + { + "link": "/docs/tooling/ai/ai-dev-tools/claude-desktop", + "redirect": "/docs/tooling/ai/vibe-coding/claude-desktop" + }, + { + "link": "/docs/tooling/ai/ai-dev-tools/lovable", + "redirect": "/docs/tooling/ai/vibe-coding/lovable" + }, + { + "link": "/docs/tooling/ai/ai-dev-tools/emergent", + "redirect": "/docs/tooling/ai/vibe-coding/emergent" + }, + { + "link": "/docs/tooling/ai/ai-dev-tools/bolt", + "redirect": "/docs/tooling/ai/vibe-coding/bolt" + }, + { + "link": "/docs/tooling/ai/ai-dev-tools/zenflow", + "redirect": "/docs/tooling/ai/vibe-coding/zenflow" + }, { "link": "/install/compose", "redirect": "/docs/advanced/self-hosting/installation#manual-installation" diff --git a/src/routes/(marketing)/(components)/ai.svelte b/src/routes/(marketing)/(components)/ai.svelte index c522d00d76c..ac4a91b8eea 100644 --- a/src/routes/(marketing)/(components)/ai.svelte +++ b/src/routes/(marketing)/(components)/ai.svelte @@ -19,7 +19,7 @@ const tools: AiStripTool[] = [ { name: 'Claude Code', - href: '/docs/tooling/ai/ai-dev-tools/claude-code', + href: '/docs/tooling/ai/agentic-coding/claude-code', dark: '/images/docs/mcp/logos/dark/claude.svg', light: '/images/docs/mcp/logos/claude.svg', primary: '#D97659', @@ -27,7 +27,7 @@ }, { name: 'Codex', - href: '/docs/tooling/ai/ai-dev-tools/codex', + href: '/docs/tooling/ai/agentic-coding/codex', dark: '/images/docs/mcp/logos/dark/openai.svg', light: '/images/docs/mcp/logos/openai.svg', primary: '#10A37F', @@ -35,7 +35,7 @@ }, { name: 'Cursor', - href: '/docs/tooling/ai/ai-dev-tools/cursor', + href: '/docs/tooling/ai/agentic-coding/cursor', dark: '/images/docs/mcp/logos/dark/cursor-ai.svg', light: '/images/docs/mcp/logos/cursor-ai.svg', primary: '#141414', @@ -43,7 +43,7 @@ }, { name: 'VS Code', - href: '/docs/tooling/ai/ai-dev-tools/vscode', + href: '/docs/tooling/ai/agentic-coding/vscode', dark: '/images/docs/mcp/logos/dark/vscode.svg', light: '/images/docs/mcp/logos/vscode.svg', primary: '#0078D7', @@ -51,7 +51,7 @@ }, { name: 'OpenCode', - href: '/docs/tooling/ai/ai-dev-tools/opencode', + href: '/docs/tooling/ai/agentic-coding/opencode', dark: '/images/docs/mcp/logos/dark/opencode.svg', light: '/images/docs/mcp/logos/opencode.svg', primary: '#FFFFFF', @@ -59,7 +59,7 @@ }, { name: 'Google Antigravity', - href: '/docs/tooling/ai/ai-dev-tools/antigravity', + href: '/docs/tooling/ai/agentic-coding/antigravity', dark: '/images/docs/mcp/logos/dark/google-antigravity.svg', light: '/images/docs/mcp/logos/google-antigravity.svg', primary: '#4285F4', diff --git a/src/routes/(marketing)/(components)/platforms.svelte b/src/routes/(marketing)/(components)/platforms.svelte index 2330287f062..c820514ba12 100644 --- a/src/routes/(marketing)/(components)/platforms.svelte +++ b/src/routes/(marketing)/(components)/platforms.svelte @@ -37,7 +37,7 @@ name: 'Codex', dark: '/images/docs/mcp/logos/dark/openai.svg', light: '/images/docs/mcp/logos/openai.svg', - href: '/docs/tooling/ai/ai-dev-tools/codex', + href: '/docs/tooling/ai/agentic-coding/codex', primary: '#10A37F', secondary: '#064E3B' }, @@ -53,7 +53,7 @@ name: 'Lovable', dark: '/images/docs/mcp/logos/dark/lovable.svg', light: '/images/docs/mcp/logos/lovable.svg', - href: '/docs/tooling/ai/ai-dev-tools/lovable', + href: '/docs/tooling/ai/vibe-coding/lovable', primary: '#FF6355', secondary: '#C43D32' }, diff --git a/src/routes/docs/+page.svelte b/src/routes/docs/+page.svelte index 91eb9340456..0597c09e277 100644 --- a/src/routes/docs/+page.svelte +++ b/src/routes/docs/+page.svelte @@ -38,7 +38,7 @@ event: 'docs-ai-ide_claude-code-click' }, { - href: '/docs/tooling/ai/ai-dev-tools/codex', + href: '/docs/tooling/ai/agentic-coding/codex', title: 'Codex', logoDark: '/images/docs/mcp/logos/dark/openai.svg', logoLight: '/images/docs/mcp/logos/openai.svg', @@ -83,21 +83,21 @@ event: 'docs-ai-vibe_claude-desktop-click' }, { - href: '/docs/tooling/ai/ai-dev-tools/lovable', + href: '/docs/tooling/ai/vibe-coding/lovable', title: 'Lovable', logoDark: '/images/docs/mcp/logos/dark/lovable.svg', logoLight: '/images/docs/mcp/logos/lovable.svg', event: 'docs-ai-vibe_lovable-click' }, { - href: '/docs/tooling/ai/ai-dev-tools/emergent', + href: '/docs/tooling/ai/vibe-coding/emergent', title: 'Emergent', logoDark: '/images/docs/mcp/logos/dark/emergent.svg', logoLight: '/images/docs/mcp/logos/emergent.svg', event: 'docs-ai-vibe_emergent-click' }, { - href: '/docs/tooling/ai/ai-dev-tools/bolt', + href: '/docs/tooling/ai/vibe-coding/bolt', title: 'Bolt', logoDark: '/images/docs/mcp/logos/dark/bolt.svg', logoLight: '/images/docs/mcp/logos/bolt.svg', diff --git a/src/routes/docs/tooling/ai/+layout.svelte b/src/routes/docs/tooling/ai/+layout.svelte index ef43e155d55..57d8b0eeee6 100644 --- a/src/routes/docs/tooling/ai/+layout.svelte +++ b/src/routes/docs/tooling/ai/+layout.svelte @@ -51,27 +51,27 @@ items: [ { label: 'Claude Code', - href: '/docs/tooling/ai/ai-dev-tools/claude-code' + href: '/docs/tooling/ai/agentic-coding/claude-code' }, { label: 'Codex', - href: '/docs/tooling/ai/ai-dev-tools/codex' + href: '/docs/tooling/ai/agentic-coding/codex' }, { label: 'Cursor', - href: '/docs/tooling/ai/ai-dev-tools/cursor' + href: '/docs/tooling/ai/agentic-coding/cursor' }, { label: 'VS Code', - href: '/docs/tooling/ai/ai-dev-tools/vscode' + href: '/docs/tooling/ai/agentic-coding/vscode' }, { label: 'OpenCode', - href: '/docs/tooling/ai/ai-dev-tools/opencode' + href: '/docs/tooling/ai/agentic-coding/opencode' }, { label: 'Google Antigravity', - href: '/docs/tooling/ai/ai-dev-tools/antigravity' + href: '/docs/tooling/ai/agentic-coding/antigravity' } ] }, @@ -80,23 +80,23 @@ items: [ { label: 'Claude Desktop', - href: '/docs/tooling/ai/ai-dev-tools/claude-desktop' + href: '/docs/tooling/ai/vibe-coding/claude-desktop' }, { label: 'Lovable', - href: '/docs/tooling/ai/ai-dev-tools/lovable' + href: '/docs/tooling/ai/vibe-coding/lovable' }, { label: 'Emergent', - href: '/docs/tooling/ai/ai-dev-tools/emergent' + href: '/docs/tooling/ai/vibe-coding/emergent' }, { label: 'Bolt', - href: '/docs/tooling/ai/ai-dev-tools/bolt' + href: '/docs/tooling/ai/vibe-coding/bolt' }, { label: 'Zenflow', - href: '/docs/tooling/ai/ai-dev-tools/zenflow' + href: '/docs/tooling/ai/vibe-coding/zenflow' } ] }, diff --git a/src/routes/docs/tooling/ai/+page.markdoc b/src/routes/docs/tooling/ai/+page.markdoc index 00747cf732e..0376a9b180b 100644 --- a/src/routes/docs/tooling/ai/+page.markdoc +++ b/src/routes/docs/tooling/ai/+page.markdoc @@ -13,22 +13,22 @@ AI-powered IDEs and code editors provide intelligent code completion and context {% only_light %} {% cards %} -{% cards_item href="/docs/tooling/ai/ai-dev-tools/claude-code" title="Claude Code" image="/images/docs/mcp/logos/claude.svg" %} +{% cards_item href="/docs/tooling/ai/agentic-coding/claude-code" title="Claude Code" image="/images/docs/mcp/logos/claude.svg" %} {% /cards_item %} -{% cards_item href="/docs/tooling/ai/ai-dev-tools/codex" title="Codex" image="/images/docs/mcp/logos/openai.svg" %} +{% cards_item href="/docs/tooling/ai/agentic-coding/codex" title="Codex" image="/images/docs/mcp/logos/openai.svg" %} {% /cards_item %} -{% cards_item href="/docs/tooling/ai/ai-dev-tools/cursor" title="Cursor" image="/images/docs/mcp/logos/cursor-ai.svg" %} +{% cards_item href="/docs/tooling/ai/agentic-coding/cursor" title="Cursor" image="/images/docs/mcp/logos/cursor-ai.svg" %} {% /cards_item %} -{% cards_item href="/docs/tooling/ai/ai-dev-tools/vscode" title="VS Code" image="/images/docs/mcp/logos/vscode.svg" %} +{% cards_item href="/docs/tooling/ai/agentic-coding/vscode" title="VS Code" image="/images/docs/mcp/logos/vscode.svg" %} {% /cards_item %} -{% cards_item href="/docs/tooling/ai/ai-dev-tools/opencode" title="OpenCode" image="/images/docs/mcp/logos/opencode.svg" %} +{% cards_item href="/docs/tooling/ai/agentic-coding/opencode" title="OpenCode" image="/images/docs/mcp/logos/opencode.svg" %} {% /cards_item %} -{% cards_item href="/docs/tooling/ai/ai-dev-tools/antigravity" title="Antigravity" image="/images/docs/mcp/logos/google-antigravity.svg" %} +{% cards_item href="/docs/tooling/ai/agentic-coding/antigravity" title="Antigravity" image="/images/docs/mcp/logos/google-antigravity.svg" %} {% /cards_item %} {% /cards %} @@ -37,22 +37,22 @@ AI-powered IDEs and code editors provide intelligent code completion and context {% only_dark %} {% cards %} -{% cards_item href="/docs/tooling/ai/ai-dev-tools/claude-code" title="Claude Code" image="/images/docs/mcp/logos/dark/claude.svg" %} +{% cards_item href="/docs/tooling/ai/agentic-coding/claude-code" title="Claude Code" image="/images/docs/mcp/logos/dark/claude.svg" %} {% /cards_item %} -{% cards_item href="/docs/tooling/ai/ai-dev-tools/codex" title="Codex" image="/images/docs/mcp/logos/dark/openai.svg" %} +{% cards_item href="/docs/tooling/ai/agentic-coding/codex" title="Codex" image="/images/docs/mcp/logos/dark/openai.svg" %} {% /cards_item %} -{% cards_item href="/docs/tooling/ai/ai-dev-tools/cursor" title="Cursor" image="/images/docs/mcp/logos/dark/cursor-ai.svg" %} +{% cards_item href="/docs/tooling/ai/agentic-coding/cursor" title="Cursor" image="/images/docs/mcp/logos/dark/cursor-ai.svg" %} {% /cards_item %} -{% cards_item href="/docs/tooling/ai/ai-dev-tools/vscode" title="VS Code" image="/images/docs/mcp/logos/dark/vscode.svg" %} +{% cards_item href="/docs/tooling/ai/agentic-coding/vscode" title="VS Code" image="/images/docs/mcp/logos/dark/vscode.svg" %} {% /cards_item %} -{% cards_item href="/docs/tooling/ai/ai-dev-tools/opencode" title="OpenCode" image="/images/docs/mcp/logos/dark/opencode.svg" %} +{% cards_item href="/docs/tooling/ai/agentic-coding/opencode" title="OpenCode" image="/images/docs/mcp/logos/dark/opencode.svg" %} {% /cards_item %} -{% cards_item href="/docs/tooling/ai/ai-dev-tools/antigravity" title="Antigravity" image="/images/docs/mcp/logos/dark/google-antigravity.svg" %} +{% cards_item href="/docs/tooling/ai/agentic-coding/antigravity" title="Antigravity" image="/images/docs/mcp/logos/dark/google-antigravity.svg" %} {% /cards_item %} {% /cards %} @@ -65,19 +65,19 @@ Vibe coding platforms let you build applications through natural language. Descr {% only_light %} {% cards %} -{% cards_item href="/docs/tooling/ai/ai-dev-tools/claude-desktop" title="Claude Desktop" image="/images/docs/mcp/logos/claude.svg" %} +{% cards_item href="/docs/tooling/ai/vibe-coding/claude-desktop" title="Claude Desktop" image="/images/docs/mcp/logos/claude.svg" %} {% /cards_item %} -{% cards_item href="/docs/tooling/ai/ai-dev-tools/lovable" title="Lovable" image="/images/docs/mcp/logos/lovable.svg" %} +{% cards_item href="/docs/tooling/ai/vibe-coding/lovable" title="Lovable" image="/images/docs/mcp/logos/lovable.svg" %} {% /cards_item %} -{% cards_item href="/docs/tooling/ai/ai-dev-tools/emergent" title="Emergent" image="/images/docs/mcp/logos/emergent.svg" %} +{% cards_item href="/docs/tooling/ai/vibe-coding/emergent" title="Emergent" image="/images/docs/mcp/logos/emergent.svg" %} {% /cards_item %} -{% cards_item href="/docs/tooling/ai/ai-dev-tools/bolt" title="Bolt" image="/images/docs/mcp/logos/bolt.svg" %} +{% cards_item href="/docs/tooling/ai/vibe-coding/bolt" title="Bolt" image="/images/docs/mcp/logos/bolt.svg" %} {% /cards_item %} -{% cards_item href="/docs/tooling/ai/ai-dev-tools/zenflow" title="Zenflow" image="/images/docs/mcp/logos/zenflow.svg" %} +{% cards_item href="/docs/tooling/ai/vibe-coding/zenflow" title="Zenflow" image="/images/docs/mcp/logos/zenflow.svg" %} {% /cards_item %} {% /cards %} @@ -86,19 +86,19 @@ Vibe coding platforms let you build applications through natural language. Descr {% only_dark %} {% cards %} -{% cards_item href="/docs/tooling/ai/ai-dev-tools/claude-desktop" title="Claude Desktop" image="/images/docs/mcp/logos/dark/claude.svg" %} +{% cards_item href="/docs/tooling/ai/vibe-coding/claude-desktop" title="Claude Desktop" image="/images/docs/mcp/logos/dark/claude.svg" %} {% /cards_item %} -{% cards_item href="/docs/tooling/ai/ai-dev-tools/lovable" title="Lovable" image="/images/docs/mcp/logos/dark/lovable.svg" %} +{% cards_item href="/docs/tooling/ai/vibe-coding/lovable" title="Lovable" image="/images/docs/mcp/logos/dark/lovable.svg" %} {% /cards_item %} -{% cards_item href="/docs/tooling/ai/ai-dev-tools/emergent" title="Emergent" image="/images/docs/mcp/logos/dark/emergent.svg" %} +{% cards_item href="/docs/tooling/ai/vibe-coding/emergent" title="Emergent" image="/images/docs/mcp/logos/dark/emergent.svg" %} {% /cards_item %} -{% cards_item href="/docs/tooling/ai/ai-dev-tools/bolt" title="Bolt" image="/images/docs/mcp/logos/dark/bolt.svg" %} +{% cards_item href="/docs/tooling/ai/vibe-coding/bolt" title="Bolt" image="/images/docs/mcp/logos/dark/bolt.svg" %} {% /cards_item %} -{% cards_item href="/docs/tooling/ai/ai-dev-tools/zenflow" title="Zenflow" image="/images/docs/mcp/logos/dark/zenflow.svg" %} +{% cards_item href="/docs/tooling/ai/vibe-coding/zenflow" title="Zenflow" image="/images/docs/mcp/logos/dark/zenflow.svg" %} {% /cards_item %} {% /cards %} diff --git a/src/routes/docs/tooling/ai/ai-dev-tools/antigravity/+page.markdoc b/src/routes/docs/tooling/ai/agentic-coding/antigravity/+page.markdoc similarity index 100% rename from src/routes/docs/tooling/ai/ai-dev-tools/antigravity/+page.markdoc rename to src/routes/docs/tooling/ai/agentic-coding/antigravity/+page.markdoc diff --git a/src/routes/docs/tooling/ai/ai-dev-tools/claude-code/+page.markdoc b/src/routes/docs/tooling/ai/agentic-coding/claude-code/+page.markdoc similarity index 100% rename from src/routes/docs/tooling/ai/ai-dev-tools/claude-code/+page.markdoc rename to src/routes/docs/tooling/ai/agentic-coding/claude-code/+page.markdoc diff --git a/src/routes/docs/tooling/ai/ai-dev-tools/codex/+page.markdoc b/src/routes/docs/tooling/ai/agentic-coding/codex/+page.markdoc similarity index 100% rename from src/routes/docs/tooling/ai/ai-dev-tools/codex/+page.markdoc rename to src/routes/docs/tooling/ai/agentic-coding/codex/+page.markdoc diff --git a/src/routes/docs/tooling/ai/ai-dev-tools/cursor/+page.markdoc b/src/routes/docs/tooling/ai/agentic-coding/cursor/+page.markdoc similarity index 100% rename from src/routes/docs/tooling/ai/ai-dev-tools/cursor/+page.markdoc rename to src/routes/docs/tooling/ai/agentic-coding/cursor/+page.markdoc diff --git a/src/routes/docs/tooling/ai/ai-dev-tools/opencode/+page.markdoc b/src/routes/docs/tooling/ai/agentic-coding/opencode/+page.markdoc similarity index 100% rename from src/routes/docs/tooling/ai/ai-dev-tools/opencode/+page.markdoc rename to src/routes/docs/tooling/ai/agentic-coding/opencode/+page.markdoc diff --git a/src/routes/docs/tooling/ai/ai-dev-tools/vscode/+page.markdoc b/src/routes/docs/tooling/ai/agentic-coding/vscode/+page.markdoc similarity index 100% rename from src/routes/docs/tooling/ai/ai-dev-tools/vscode/+page.markdoc rename to src/routes/docs/tooling/ai/agentic-coding/vscode/+page.markdoc diff --git a/src/routes/docs/tooling/ai/ai-dev-tools/windsurf/+page.markdoc b/src/routes/docs/tooling/ai/agentic-coding/windsurf/+page.markdoc similarity index 100% rename from src/routes/docs/tooling/ai/ai-dev-tools/windsurf/+page.markdoc rename to src/routes/docs/tooling/ai/agentic-coding/windsurf/+page.markdoc diff --git a/src/routes/docs/tooling/ai/responsible-ai/+page.markdoc b/src/routes/docs/tooling/ai/responsible-ai/+page.markdoc index cef7217eb07..641dad336fd 100644 --- a/src/routes/docs/tooling/ai/responsible-ai/+page.markdoc +++ b/src/routes/docs/tooling/ai/responsible-ai/+page.markdoc @@ -42,7 +42,7 @@ Users should understand when they are interacting with AI-generated content or A # AI-assisted development {% #ai-assisted-development %} -When using AI development tools like [Cursor, VS Code, or Claude Code](/docs/tooling/ai/ai-dev-tools) to build with Appwrite, keep the following in mind. +When using AI development tools like [Cursor, VS Code, or Claude Code](/docs/tooling/ai/agentic-coding/cursor) to build with Appwrite, keep the following in mind. - **Review generated code** before committing. AI-generated code may contain security vulnerabilities, incorrect API usage, or outdated patterns. - **Keep API keys out of prompts** when chatting with AI assistants. Avoid pasting secrets, credentials, or sensitive configuration into AI chat interfaces. diff --git a/src/routes/docs/tooling/ai/ai-dev-tools/bolt/+page.markdoc b/src/routes/docs/tooling/ai/vibe-coding/bolt/+page.markdoc similarity index 100% rename from src/routes/docs/tooling/ai/ai-dev-tools/bolt/+page.markdoc rename to src/routes/docs/tooling/ai/vibe-coding/bolt/+page.markdoc diff --git a/src/routes/docs/tooling/ai/ai-dev-tools/claude-desktop/+page.markdoc b/src/routes/docs/tooling/ai/vibe-coding/claude-desktop/+page.markdoc similarity index 100% rename from src/routes/docs/tooling/ai/ai-dev-tools/claude-desktop/+page.markdoc rename to src/routes/docs/tooling/ai/vibe-coding/claude-desktop/+page.markdoc diff --git a/src/routes/docs/tooling/ai/ai-dev-tools/emergent/+page.markdoc b/src/routes/docs/tooling/ai/vibe-coding/emergent/+page.markdoc similarity index 100% rename from src/routes/docs/tooling/ai/ai-dev-tools/emergent/+page.markdoc rename to src/routes/docs/tooling/ai/vibe-coding/emergent/+page.markdoc diff --git a/src/routes/docs/tooling/ai/ai-dev-tools/lovable/+page.markdoc b/src/routes/docs/tooling/ai/vibe-coding/lovable/+page.markdoc similarity index 100% rename from src/routes/docs/tooling/ai/ai-dev-tools/lovable/+page.markdoc rename to src/routes/docs/tooling/ai/vibe-coding/lovable/+page.markdoc diff --git a/src/routes/docs/tooling/ai/ai-dev-tools/zenflow/+page.markdoc b/src/routes/docs/tooling/ai/vibe-coding/zenflow/+page.markdoc similarity index 100% rename from src/routes/docs/tooling/ai/ai-dev-tools/zenflow/+page.markdoc rename to src/routes/docs/tooling/ai/vibe-coding/zenflow/+page.markdoc diff --git a/src/routes/docs/tooling/mcp/+layout.svelte b/src/routes/docs/tooling/mcp/+layout.svelte deleted file mode 100644 index cbba3af773b..00000000000 --- a/src/routes/docs/tooling/mcp/+layout.svelte +++ /dev/null @@ -1,78 +0,0 @@ - - - - - - diff --git a/src/routes/docs/tooling/mcp/+page.markdoc b/src/routes/docs/tooling/mcp/+page.markdoc deleted file mode 100644 index e477e69188b..00000000000 --- a/src/routes/docs/tooling/mcp/+page.markdoc +++ /dev/null @@ -1,41 +0,0 @@ ---- -layout: article -title: Model Context Protocol -description: Enable LLMs and code-generation tools to interact with your Appwrite project ---- - -Appwrite offers [Model Context Protocol](https://modelcontextprotocol.io) (MCP) servers that allow LLMs to directly interact with Appwrite's API and docs. Using MCP servers, you can use applications such as Claude Desktop, Cursor, Windsurf Editor, etc. to operate on your Appwrite project as well as gain context about the latest updates to Appwrite's SDKs, APIs, and CLI. - -# What is MCP? - -The Model Context Protocol (MCP) is an open standard that enables Large Language Models (LLMs) and AI code-generation tools to interact with APIs and documentation in a structured manner. MCP servers provide a bridge between LLMs and external services, allowing them to perform actions such as querying databases, managing users, and accessing files. - -The key benefits of using MCP servers include: - -- **Enhanced capabilities**: LLMs can perform complex tasks by interacting with APIs, going beyond simple text generation. -- **Improved context**: By accessing up-to-date documentation and API definitions, LLMs can provide more accurate and relevant responses. -- **Seamless integration**: MCP servers can be easily integrated with popular AI tools and code editors, enhancing their functionality. - -# Available MCP servers - -Appwrite currently offers the following MCP servers: - -{% cards %} - -{% cards_item href="/docs/tooling/mcp/api" title="MCP server for Appwrite API" icon="icon-globe-alt"%} -{% /cards_item %} - -{% cards_item href="/docs/tooling/mcp/docs" title="MCP server for Appwrite docs" icon="icon-document-text" %} -{% /cards_item %} - -{% /cards %} - -## Why use Appwrite's MCP servers? - -Some **popular use cases** for Appwrite's MCP servers include: - -- **Code generation**: Automatically generate code snippets or entire files based on user input and context. -- **Documentation lookup**: Quickly find relevant documentation for specific API endpoints or SDK features. -- **Project management**: Create, update, or delete resources in your Appwrite project using natural language commands. -- **Debugging assistance**: Get help with debugging issues by providing context about your project and recent changes. -- **Learning and exploration**: Explore Appwrite's features and capabilities through interactive conversations with LLMs. \ No newline at end of file diff --git a/src/routes/docs/tooling/mcp/antigravity/+page.markdoc b/src/routes/docs/tooling/mcp/antigravity/+page.markdoc deleted file mode 100644 index 0727f12d31f..00000000000 --- a/src/routes/docs/tooling/mcp/antigravity/+page.markdoc +++ /dev/null @@ -1,116 +0,0 @@ ---- -layout: article -title: Appwrite MCP and Google Antigravity -description: Learn how to add the Appwrite MCP servers to Agent Manager in Google Antigravity to interact with both the Appwrite API and documentation. ---- - -Learn how you can add the Appwrite MCP servers to Agent Manager in Google Antigravity to interact with both 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" %} - -[Node.js](https://nodejs.org/en/download) and npm must be installed on your system. - -{% /tabsitem %} -{% /tabs %} - -{% section #step-1 step=1 title="Add MCP servers" %} - -To add the Appwrite MCP server, open Antigravity and go to the drop-down (...) menu in the Agent window . From there, navigate to Manage MCP Servers in the MCP Store, and then click View raw config in the main panel to add your custom MCP server. - -{% tabs %} -{% tabsitem #api-only title="API server" %} - -Update the `mcp_config.json` file to include the API server: - -```json -{ - "mcpServers": { - "appwrite-api": { - "command": "uvx", - "args": [ - "mcp-server-appwrite", - "--users" - ], - "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" %} - -Update the `mcp_config.json` file to include the docs server: - -```json -{ - "mcpServers": { - "appwrite-docs": { - "command": "npx", - "args": [ - "mcp-remote", - "https://mcp-for-docs.appwrite.io" - ] - } - } -} -``` - -{% /tabsitem %} -{% /tabs %} - -Head back to the Managed MCP Server page and click refresh. - -{% /section %} - -{% section #step-2 step=2 title="Test the integration" %} - -Open **Agent Manager** in Antigravity to 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 collections in my database` -- `Create a new document in my collection` -- `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 %} - -![Search for portfolio site in Appwrite project](/images/docs/mcp/antigravity/agent-chat.avif) - -{% /section %} \ No newline at end of file diff --git a/src/routes/docs/tooling/mcp/api/+page.markdoc b/src/routes/docs/tooling/mcp/api/+page.markdoc deleted file mode 100644 index dd28306d9ca..00000000000 --- a/src/routes/docs/tooling/mcp/api/+page.markdoc +++ /dev/null @@ -1,118 +0,0 @@ ---- -layout: article -title: MCP server for Appwrite API -description: Enable LLMs and code-generation tools to interact with the Appwrite API ---- - -The MCP server for Appwrite API allows LLMs and code-generation tools to interact with the Appwrite platform and perform various operations on your Appwrite resources, such as creating users, managing databases, and more, using natural language commands. - -Here are some of the key benefits of using the MCP server: - -- **Direct API interaction**: Enables LLMs to perform actions directly on your Appwrite project -- **Real-time data access**: Allows LLMs to fetch and manipulate live data from your Appwrite instance -- **Simplified workflows**: Facilitates complex operations through simple natural language prompts -- **Customizable tools**: Offers a range of tools for different Appwrite services, which can be enabled as needed - -# Pre-requisites {% #pre-requisites %} - -## Appwrite API key - -Before launching the MCP server, you must [set up an Appwrite project](https://cloud.appwrite.io) and create an **API key** with the necessary scopes enabled. - -{% only_light %} -![Appwrite API key](/images/docs/mcp/appwrite/appwrite-api-secret.avif) -{% /only_light %} -{% only_dark %} -![Appwrite API key](/images/docs/mcp/appwrite/dark/appwrite-api-secret.avif) -{% /only_dark %} - -Ensure you save the **API key** along with the **project ID**, **region** and **endpoint URL** from the Settings page of your project as you'll need them later. - -## Install uv - -Install [uv](https://docs.astral.sh/uv/getting-started/installation/) on your system with: - -{% tabs %} -{% tabsitem #uv-linux-macos title="Linux and MacOS" %} - -```bash -curl -LsSf https://astral.sh/uv/install.sh | sh -``` - -{% /tabsitem %} - -{% tabsitem #uv-windows title="Windows" %} - -```powershell -powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex" -``` - -{% /tabsitem %} -{% /tabs %} - -You can verify the installation by running the following command in your terminal: - -```bash -uv -``` - -# Installation {% #installation %} - -{% partial file="mcp-add-ides-tools.md" /%} - -## Command-line arguments - -Database tools are enabled by default. In addition you can pass arguments to `uvx mcp-server-appwrite [args]` to enable other MCP tools for various Appwrite APIs. - -| Argument | Description | -| --- | --- | -| `--tablesdb` | Enables the TablesDB API | -| `--users` | Enables the Users API | -| `--teams` | Enables the Teams API | -| `--storage` | Enables the Storage API | -| `--functions` | Enables the Functions API | -| `--messaging` | Enables the Messaging API | -| `--locale` | Enables the Locale API | -| `--avatars` | Enables the Avatars API | -| `--databases` | Enables the legacy Databases API | -| `--all` | Enables all Appwrite APIs | - -{% info title="Enable only necessary MCP tools" %} -When an MCP tool is enabled, the tool's definition is passed to the LLM, using up tokens from the model's available context window. As a result, the effective context window is reduced. Some IDEs may return errors if too many tools are enabled for the same reason. - -The default Appwrite MCP server ships with only the Databases tools (our most commonly used API) enabled to stay within these limits. Additional tools can be enabled using the flags above. -{% /info %} - -# Usage {% #usage %} - -Once configured, your AI assistant will have access to your Appwrite project. You can ask questions like: - -## Example 1: List users - -Run the following prompt in your preferred code editor/LLM after enabling the MCP server: - -``` -List users in my Appwrite project -``` - -![List users in Appwrite project](/images/docs/mcp/claude-desktop/claude-list-users.avif) - -## Example 2: Search a site - -Run the following prompt in your preferred code editor/LLM after enabling the MCP server: - -``` -Get the details of my portfolio site from Appwrite -``` - -![Search for portfolio site in Appwrite project](/images/docs/mcp/vscode/copilot-chat.avif) - -## Example 3: Create a user - -Run the following prompt in your preferred code editor/LLM after enabling the MCP server: - -``` -Add a user john.doe@example.com to the Appwrite project -``` - -![Create user in Appwrite project](/images/docs/mcp/cursor/cursor-create-user.avif) diff --git a/src/routes/docs/tooling/mcp/claude-code/+page.markdoc b/src/routes/docs/tooling/mcp/claude-code/+page.markdoc deleted file mode 100644 index c8b240b180c..00000000000 --- a/src/routes/docs/tooling/mcp/claude-code/+page.markdoc +++ /dev/null @@ -1,100 +0,0 @@ ---- -layout: article -title: Appwrite MCP and Claude Code -description: Learn how to add the Appwrite MCP servers to Claude= Code to interact with both the Appwrite API and documentation. ---- - -Learn how you can add the Appwrite MCP servers to Claude Code to interact with both 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" %} - -[Node.js](https://nodejs.org/en/download) and npm must be installed on your system. - -{% /tabsitem %} -{% /tabs %} - -{% section #step-1 step=1 title="Add MCP servers" %} - -Run the following commands in your terminal to add the MCP servers: - -{% tabs %} -{% tabsitem #api-only title="API server" %} - -```bash -claude mcp add-json appwrite-api '{"command":"uvx","args":["mcp-server-appwrite","--users"],"env":{"APPWRITE_PROJECT_ID": "your-project-id", "APPWRITE_API_KEY": "your-api-key", "APPWRITE_ENDPOINT": "https://.cloud.appwrite.io/v1"}}' -``` - -{% /tabsitem %} - -{% tabsitem #docs-only title="Docs server" %} - -```bash -claude mcp add appwrite-docs https://mcp-for-docs.appwrite.io -t http -``` - -{% /tabsitem %} -{% /tabs %} - -{% info title="Enable other API MCP tools" %} - -To enable additional API tools, learn more about [command-line arguments](/docs/tooling/mcp/api#command-line-arguments). - -{% /info %} - -{% /section %} - -{% section #step-2 step=2 title="Verify MCP tools" %} - -Run the following command in your terminal (where Claude Code is running). - -```bash -/mcp -``` - -You should see the added MCP servers listed there. - -![Verify MCP tools](/images/docs/mcp/claude-code/verify-mcp-tools.avif) - -{% /section %} - -{% section #step-3 step=3 title="Test the integration" %} - -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 collections in my database` -- `Create a new document in my collection` -- `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 %} - -![Implement file uploads with Appwrite Storage](/images/docs/mcp/claude-code/implement-file-uploads.avif) - -{% /section %} \ No newline at end of file diff --git a/src/routes/docs/tooling/mcp/claude-desktop/+page.markdoc b/src/routes/docs/tooling/mcp/claude-desktop/+page.markdoc deleted file mode 100644 index a753be4147d..00000000000 --- a/src/routes/docs/tooling/mcp/claude-desktop/+page.markdoc +++ /dev/null @@ -1,144 +0,0 @@ ---- -layout: article -title: Appwrite MCP and Claude Desktop -description: Learn how to add the Appwrite MCP servers to Claude Desktop to interact with both the Appwrite API and documentation. ---- - -Learn how you can add the Appwrite MCP servers to Claude Desktop to interact with both 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" %} - -[Node.js](https://nodejs.org/en/download) and npm must be installed on your system. - -{% /tabsitem %} -{% /tabs %} - -{% section #step-1 step=1 title="Add MCP servers" %} - -In the Claude Desktop app, open the app's **Settings** page (press `CTRL + ,` on Windows or `CMD + ,` on MacOS) and head to the **Developer** tab. - -![Claude Settings](/images/docs/mcp/claude-desktop/claude-settings.avif) - -Clicking on the **Edit Config** button will take you to the `claude_desktop_config.json` file. In case the file is missing, please visit the [Model Context Protocol](https://modelcontextprotocol.io/quickstart/user#2-add-the-filesystem-mcp-server) docs. - -Choose which MCP server you want to configure: - -{% tabs %} -{% tabsitem #api-only title="API server" %} - -Add the API server to your configuration: - -```json -{ - "mcpServers": { - "appwrite-api": { - "command": "uvx", - "args": [ - "mcp-server-appwrite", - "--users" - ], - "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" %} - -Add the docs server to your configuration: - -```json -{ - "mcpServers": { - "appwrite-docs": { - "command": "npx", - "args": [ - "mcp-remote", - "https://mcp-for-docs.appwrite.io" - ] - } - } -} -``` - -**Why do we use the `mcp-remote` package?** - -Unlike other IDEs, Claude Desktop only supports local (stdio) MCP servers and not remote servers. The `mcp-remote` package acts as a proxy to connect to the docs MCP server. - -{% /tabsitem %} -{% /tabs %} - -{% info title="Enable other API MCP tools" %} - -To enable additional API tools, learn more about [command-line arguments](/docs/tooling/mcp/api#command-line-arguments). - -{% /info %} - -{% /section %} - -{% section #step-2 step=2 title="Verify MCP tools" %} - -Restart the Claude Desktop app, click on the MCP tools button (at the bottom right section of the prompt input) and click on it to view available Appwrite MCP tools. - -![Appwrite MCP tools](/images/docs/mcp/claude-desktop/claude-mcp-tools.avif) - -{% info title="uvx ENOENT error" %} - -In case you see a `uvx ENOENT` error, ensure that you either add `uvx` to the `PATH` environment variable on your system or use the full path to your `uvx` installation in the config file. - -{% /info %} - -{% /section %} - -{% section #step-3 step=3 title="Test the integration" %} - -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 collections in my database` -- `Create a new document in my collection` -- `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 %} - -![List users in Appwrite project](/images/docs/mcp/claude-desktop/claude-list-users.avif) - -{% /section %} \ No newline at end of file diff --git a/src/routes/docs/tooling/mcp/cursor/+page.markdoc b/src/routes/docs/tooling/mcp/cursor/+page.markdoc deleted file mode 100644 index d59ff215a67..00000000000 --- a/src/routes/docs/tooling/mcp/cursor/+page.markdoc +++ /dev/null @@ -1,150 +0,0 @@ ---- -layout: article -title: Appwrite MCP and Cursor -description: Learn how to add the Appwrite MCP servers to Cursor to interact with both the Appwrite API and documentation. ---- - -Learn how you can add the Appwrite MCP servers to Cursor to interact with both 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" %} - -[Node.js](https://nodejs.org/en/download) and npm must be installed on your system. - -{% /tabsitem %} -{% /tabs %} - -{% section #step-1 step=1 title="Add MCP servers" %} - -Open the **Cursor Settings** page, head to the **MCP** tab, and click on the **Add new global MCP server** button. This will open an `mcp.json` file in your editor. - -Choose which MCP server you want to configure: - -{% tabs %} -{% tabsitem #api-only title="API server" %} - -Update the `mcp.json` file to include the API server: - -```json -{ - "mcpServers": { - "appwrite-api": { - "command": "uvx", - "args": [ - "mcp-server-appwrite", - "--users" - ], - "env": { - "APPWRITE_API_KEY": "your-api-key", - "APPWRITE_PROJECT_ID": "your-project-id", - "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" %} - -Update the `mcp.json` file to include the docs server: - -```json -{ - "mcpServers": { - "appwrite-docs": { - "command": "npx", - "args": [ - "mcp-remote", - "https://mcp-for-docs.appwrite.io" - ] - } - } -} -``` - -{% /tabsitem %} -{% /tabs %} - -You can also **directly add the MCP servers to Cursor** using the following links: - -{% only_light %} -{% cards %} - -{% cards_item href="https://apwr.dev/api-mcp-cursor?ref=docs" title="API server" image="/images/docs/mcp/logos/cursor-ai.svg" %} -{% /cards_item %} - -{% cards_item href="https://apwr.dev/docs-mcp-cursor?ref=docs" title="Docs server" image="/images/docs/mcp/logos/cursor-ai.svg" %} -{% /cards_item %} - -{% /cards %} -{% /only_light %} - -{% only_dark %} -{% cards %} - -{% cards_item href="https://apwr.dev/api-mcp-cursor?ref=docs" title="API server" image="/images/docs/mcp/logos/dark/cursor-ai.svg" %} -{% /cards_item %} - -{% cards_item href="https://apwr.dev/docs-mcp-cursor?ref=docs" title="Docs server" image="/images/docs/mcp/logos/dark/cursor-ai.svg" %} -{% /cards_item %} - -{% /cards %} -{% /only_dark %} - -Once you save the details, Cursor will connect with the MCP server(s) and load all available tools. You may need to restart Cursor if it is unable to start the MCP server. - -{% info title="Enable other API MCP tools" %} - -To enable additional API tools, learn more about [command-line arguments](/docs/tooling/mcp/api#command-line-arguments). - -{% /info %} - -{% /section %} - -{% section #step-2 step=2 title="Test the integration" %} - -Open Cursor Agent 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 collections in my database` -- `Create a new document in my collection` -- `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 %} - -![Create user in Appwrite project](/images/docs/mcp/cursor/cursor-create-user.avif) - -{% /section %} diff --git a/src/routes/docs/tooling/mcp/docs/+page.markdoc b/src/routes/docs/tooling/mcp/docs/+page.markdoc deleted file mode 100644 index 3f8bf006fb3..00000000000 --- a/src/routes/docs/tooling/mcp/docs/+page.markdoc +++ /dev/null @@ -1,72 +0,0 @@ ---- -layout: article -title: MCP server for Appwrite docs -description: Enable LLMs and code-generation tools to interact with the Appwrite docs ---- - -The MCP server for Appwrite documentation allows LLMs and code-generation tools to interact with comprehensive Appwrite documentation, enabling intelligent code generation for Appwrite's APIs and SDKs, troubleshooting assistance, and implementation guidance using natural language commands. - -Here are some of the key benefits of using the MCP server: - -- **Complete documentation access**: Provides AI assistants with access to all Appwrite documentation -- **Real-time context**: Ensures AI responses are based on the latest documentation -- **Intelligent search**: Enables semantic search across documentation content -- **Code examples**: Includes access to code samples and implementation guides -- **Best practices**: Shares recommended patterns and practices from official documentation - -# Pre-requisites {% #pre-requisites %} - -Install [Node.js](https://nodejs.org/en/download) and npm on your system. You can verify the installation by running the following commands in your terminal: - -```bash -node -v -npm -v -``` - -# Installation {% #installation %} - -{% partial file="mcp-add-ides-tools.md" /%} - -# Usage {% #usage %} - -Once configured, your AI assistant will have access to Appwrite documentation context. You can ask questions like: - -## Example 1: Code generation - -Run the following prompt in your preferred code editor/LLM after enabling the MCP server: - -``` -Show me how to set up real-time subscriptions that trigger on creation of a user -``` - -![Code generation example](/images/docs/mcp/mcp-for-docs/code-generation.avif) - -## Example 2: Troubleshooting - -Run the following prompt in your preferred code editor/LLM after enabling the MCP server: - -``` -I'm getting a 401 error when trying to delete a user. What could be wrong? -``` - -![Troubleshooting example](/images/docs/mcp/mcp-for-docs/troubleshooting.avif) - -## Example 3: Best practices - -Run the following prompt in your preferred code editor/LLM after enabling the MCP server: - -``` -What are some of the best security practices for Appwrite Auth in a web app with SSR? -``` - -![Best practices example](/images/docs/mcp/mcp-for-docs/best-practices.avif) - -## Example 4: API reference - -Run the following prompt in your preferred code editor/LLM after enabling the MCP server: - -``` -I want an example of how I can list all users in a Python app -``` - -![API reference example](/images/docs/mcp/mcp-for-docs/api-reference.avif) \ No newline at end of file diff --git a/src/routes/docs/tooling/mcp/opencode/+page.markdoc b/src/routes/docs/tooling/mcp/opencode/+page.markdoc deleted file mode 100644 index 4f4af41af1d..00000000000 --- a/src/routes/docs/tooling/mcp/opencode/+page.markdoc +++ /dev/null @@ -1,118 +0,0 @@ ---- -layout: article -title: Appwrite MCP and OpenCode -description: Learn how to add the Appwrite MCP servers to OpenCode to interact with both the Appwrite API and documentation. ---- - -Learn how you can add the Appwrite MCP servers to OpenCode to interact with both 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" %} - -[Node.js](https://nodejs.org/en/download) and npm must be installed on your system. - -{% /tabsitem %} -{% /tabs %} - -{% section #step-1 step=1 title="Add MCP servers" %} - -Use the following configuration in your `opencode.json` file to use the Appwrite MCP servers. - -{% tabs %} -{% tabsitem #api-only title="API server" %} - -```json -{ - "$schema": "https://opencode.ai/config.json", - "mcp": { - "appwrite": { - "type": "local", - "command": [ - "uvx", - "mcp-server-appwrite", - "--sites" - ], - "enabled": true, - "environment": { - "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" %} - -```json -{ - "$schema": "https://opencode.ai/config.json", - "mcp": { - "appwrite-docs": { - "type": "remote", - "enabled": true, - "url": "https://mcp-for-docs.appwrite.io" - } - } -} -``` - -{% /tabsitem %} -{% /tabs %} - -{% info title="Enable other API MCP tools" %} - -To enable additional API tools, learn more about [command-line arguments](/docs/tooling/mcp/api#command-line-arguments). - -{% /info %} - -{% /section %} - -{% section #step-2 step=2 title="Test the integration" %} - -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 collections in my database` -- `Create a new document in my collection` -- `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 %} - -![Implement OAuth authentication in Appwrite](/images/docs/mcp/opencode/oauth-question.avif) - -{% /section %} \ No newline at end of file diff --git a/src/routes/docs/tooling/mcp/vscode/+page.markdoc b/src/routes/docs/tooling/mcp/vscode/+page.markdoc deleted file mode 100644 index 36c7cd7ad5b..00000000000 --- a/src/routes/docs/tooling/mcp/vscode/+page.markdoc +++ /dev/null @@ -1,121 +0,0 @@ ---- -layout: article -title: Appwrite MCP and VS Code -description: Learn how to add the Appwrite MCP servers to GitHub Copilot Chat in VS Code to interact with both the Appwrite API and documentation. ---- - -Learn how you can add the Appwrite MCP servers to GitHub Copilot Chat in VS Code to interact with both 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" %} - -[Node.js](https://nodejs.org/en/download) and npm must be installed on your system. - -{% /tabsitem %} -{% /tabs %} - -{% section #step-1 step=1 title="Add MCP servers" %} - -In VS Code, open the **Command Palette** (press `CTRL + Shift + P` on Windows or `CMD + Shift + P` on MacOS) and run the `MCP: Open User Configuration` command. - -Choose which MCP servers you want to configure: - -{% tabs %} -{% tabsitem #api-only title="API server" %} - -Update the `mcp.json` file to include the API server: - -```json -{ - "servers": { - "appwrite-api": { - "command": "uvx", - "args": [ - "mcp-server-appwrite", - "--sites" - ], - "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" %} - -Update the `mcp.json` file to include the docs server: - -```json -{ - "servers": { - "appwrite-docs": { - "url": "https://mcp-for-docs.appwrite.io", - "type": "http" - } - } -} -``` - -{% /tabsitem %} -{% /tabs %} - -Once you save the configuration, Copilot Chat will connect with the MCP server(s) and load all available tools. - -{% info title="Enable other API MCP tools" %} - -To enable additional API tools, learn more about [command-line arguments](/docs/tooling/mcp/api#command-line-arguments). - -{% /info %} - -{% /section %} - -{% section #step-2 step=2 title="Test the integration" %} - -Open **Copilot Chat** in VS Code and switch to **Agent Mode** to 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 collections in my database` -- `Create a new document in my collection` -- `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 %} - -![Search for portfolio site in Appwrite project](/images/docs/mcp/vscode/copilot-chat.avif) - -{% /section %} \ No newline at end of file diff --git a/src/routes/docs/tooling/mcp/windsurf/+page.markdoc b/src/routes/docs/tooling/mcp/windsurf/+page.markdoc deleted file mode 100644 index c0d132a66ba..00000000000 --- a/src/routes/docs/tooling/mcp/windsurf/+page.markdoc +++ /dev/null @@ -1,123 +0,0 @@ ---- -layout: article -title: Appwrite MCP and Windsurf Editor -description: Learn how to add the Appwrite MCP servers to Windsurf Editor to interact with both the Appwrite API and documentation. ---- - -Learn how you can add the Appwrite MCP servers to Windsurf Editor to interact with both 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" %} - -[Node.js](https://nodejs.org/en/download) and npm must be installed on your system. - -{% /tabsitem %} -{% /tabs %} - -{% section #step-1 step=1 title="Add MCP servers" %} - -Open the **Windsurf Settings** page, head to the **Cascade** tab, find the **Model Context Protocol (MCP) Servers** section, and click on the **View raw config** button. - -![Add MCP server](/images/docs/mcp/windsurf/windsurf-add-mcp-server.avif) - -Choose which MCP server you want to configure: - -{% tabs %} -{% tabsitem #api-only title="API server" %} - -Update the `mcp_config.json` file to include the API server: - -```json -{ - "mcpServers": { - "appwrite-api": { - "command": "uvx", - "args": [ - "mcp-server-appwrite", - "--databases", - "--users" - ], - "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" %} - -Update the `mcp_config.json` file to include the docs server: - -```json -{ - "mcpServers": { - "appwrite-docs": { - "serverUrl": "https://mcp-for-docs.appwrite.io" - } - } -} -``` - -{% /tabsitem %} -{% /tabs %} - -Once you save the details, head back to the MCP Servers section in the Windsurf Settings and click on the **Refresh** button. - -{% info title="Enable other API MCP tools" %} - -To enable additional API tools, learn more about [command-line arguments](/docs/tooling/mcp/api#command-line-arguments). - -{% /info %} - -{% /section %} - -{% section #step-2 step=2 title="Test the integration" %} - -Open Cascade chat in the Windsurf Editor 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 collections in my database` -- `Create a new document in my collection` -- `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 %} - -![List data from an Appwrite database](/images/docs/mcp/windsurf/windsurf-cascade-chat.avif) - -{% /section %} \ No newline at end of file diff --git a/src/routes/docs/tooling/mcp/zenflow/+page.markdoc b/src/routes/docs/tooling/mcp/zenflow/+page.markdoc deleted file mode 100644 index d437a8b7dcd..00000000000 --- a/src/routes/docs/tooling/mcp/zenflow/+page.markdoc +++ /dev/null @@ -1,120 +0,0 @@ ---- -layout: article -title: Appwrite MCP and Zenflow -description: Learn how to add the Appwrite MCP servers to agents in Zenflow to interact with both the Appwrite API and documentation. ---- - -Learn how you can add the Appwrite MCP servers to agents in Zenflow to interact with both the Appwrite API and documentation. - -Before you begin, ensure you have the following **prerequisites** 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" %} - -[Node.js](https://nodejs.org/en/download) and npm must be installed on your system. - -{% /tabsitem %} -{% /tabs %} - -{% section #step-1 step=1 title="Add MCP servers" %} - -To add the Appwrite MCP server, open Zenflow and go to the **Settings** > **MCP servers**. From there, select your agent you want to configure MCP for, and then add your custom MCP server. - -{% tabs %} -{% tabsitem #api-only title="API server" %} - -```json -{ - "mcpServers": { - "appwrite-api": { - "command": "uvx", - "args": [ - "mcp-server-appwrite", - "--sites" - ], - "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" %} - -Update the -```json -{ - "mcpServers": {} -} -``` -to include the docs server: - -```json -{ - "mcpServers": { - "appwrite-docs": { - "url": "https://mcp-for-docs.appwrite.io", - "type": "http" - } - } -} -``` - -{% /tabsitem %} -{% /tabs %} - -Click **Save**. Once you save the configuration, Zenflow will connect with the MCP server(s) and load all available tools. - -{% /section %} - -{% section #step-2 step=2 title="Test the integration" %} - -Open **Zenflow Chat** of your existing task to test your MCP integrations. If you don't have an existing task, you can create one by clicking **New Task**, selecting a task type, and writing a task description. Click **Create and Run**. -If you are new to Zenflow, learn more about [how to set up Zenflow](https://docs.zencoder.ai/user-guides/guides/set-up-your-zenflow#step-6:-create-your-first-task). - -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 collections in my database` -- `Create a new document in my collection` -- `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 %} - -![Search for portfolio site in Appwrite project](/images/docs/mcp/zenflow/zenflow-chat.avif) - - -{% /section %} \ No newline at end of file From ace71bfa882d9d2e43bdaa59ab356b58645554c1 Mon Sep 17 00:00:00 2001 From: Atharva Deosthale Date: Mon, 18 May 2026 13:51:25 +0530 Subject: [PATCH 2/2] Fix stale links in mcp partial and responsible-ai --- src/partials/mcp-add-ides-tools.md | 8 ++++---- src/routes/docs/tooling/ai/responsible-ai/+page.markdoc | 2 +- 2 files changed, 5 insertions(+), 5 deletions(-) diff --git a/src/partials/mcp-add-ides-tools.md b/src/partials/mcp-add-ides-tools.md index 28d2f5c6067..f09c6b3c7d2 100644 --- a/src/partials/mcp-add-ides-tools.md +++ b/src/partials/mcp-add-ides-tools.md @@ -9,13 +9,13 @@ You can add the MCP server to various AI tools and code editors: {% cards_item href="/docs/tooling/ai/agentic-coding/codex" title="Codex" image="/images/docs/mcp/logos/openai.svg" %} {% /cards_item %} -{% cards_item href="/docs/tooling/mcp/cursor" title="Cursor" image="/images/docs/mcp/logos/cursor-ai.svg" %} +{% cards_item href="/docs/tooling/ai/agentic-coding/cursor" title="Cursor" image="/images/docs/mcp/logos/cursor-ai.svg" %} {% /cards_item %} {% cards_item href="/docs/tooling/ai/vibe-coding/claude-desktop" title="Claude Desktop" image="/images/docs/mcp/logos/claude.svg" %} {% /cards_item %} -{% cards_item href="/docs/tooling/mcp/zenflow" title="Zenflow" image="/images/docs/mcp/logos/zenflow.svg" %} +{% cards_item href="/docs/tooling/ai/vibe-coding/zenflow" title="Zenflow" image="/images/docs/mcp/logos/zenflow.svg" %} {% /cards_item %} {% cards_item href="/docs/tooling/ai/agentic-coding/vscode" title="VS Code" image="/images/docs/mcp/logos/vscode.svg" %} @@ -39,13 +39,13 @@ You can add the MCP server to various AI tools and code editors: {% cards_item href="/docs/tooling/ai/agentic-coding/codex" title="Codex" image="/images/docs/mcp/logos/dark/openai.svg" %} {% /cards_item %} -{% cards_item href="/docs/tooling/mcp/cursor" title="Cursor" image="/images/docs/mcp/logos/dark/cursor-ai.svg" %} +{% cards_item href="/docs/tooling/ai/agentic-coding/cursor" title="Cursor" image="/images/docs/mcp/logos/dark/cursor-ai.svg" %} {% /cards_item %} {% cards_item href="/docs/tooling/ai/vibe-coding/claude-desktop" title="Claude Desktop" image="/images/docs/mcp/logos/dark/claude.svg" %} {% /cards_item %} -{% cards_item href="/docs/tooling/mcp/zenflow" title="Zenflow" image="/images/docs/mcp/logos/dark/zenflow.svg" %} +{% cards_item href="/docs/tooling/ai/vibe-coding/zenflow" title="Zenflow" image="/images/docs/mcp/logos/dark/zenflow.svg" %} {% /cards_item %} {% cards_item href="/docs/tooling/ai/agentic-coding/vscode" title="VS Code" image="/images/docs/mcp/logos/dark/vscode.svg" %} diff --git a/src/routes/docs/tooling/ai/responsible-ai/+page.markdoc b/src/routes/docs/tooling/ai/responsible-ai/+page.markdoc index 641dad336fd..e8aeec7c1d6 100644 --- a/src/routes/docs/tooling/ai/responsible-ai/+page.markdoc +++ b/src/routes/docs/tooling/ai/responsible-ai/+page.markdoc @@ -42,7 +42,7 @@ Users should understand when they are interacting with AI-generated content or A # AI-assisted development {% #ai-assisted-development %} -When using AI development tools like [Cursor, VS Code, or Claude Code](/docs/tooling/ai/agentic-coding/cursor) to build with Appwrite, keep the following in mind. +When using AI development tools like [Cursor, VS Code, or Claude Code](/docs/tooling/ai/) to build with Appwrite, keep the following in mind. - **Review generated code** before committing. AI-generated code may contain security vulnerabilities, incorrect API usage, or outdated patterns. - **Keep API keys out of prompts** when chatting with AI assistants. Avoid pasting secrets, credentials, or sensitive configuration into AI chat interfaces.