diff --git a/.optimize-cache.json b/.optimize-cache.json index 5bd7b85ba8..8df98138bd 100644 --- a/.optimize-cache.json +++ b/.optimize-cache.json @@ -154,6 +154,7 @@ "images/blog/ai-vibe-coding-insights/tweet.png": "4025c2236fcfc74d6435911a26239a8fef889005908ab83b6ee5f010ad3533cd", "images/blog/announcing-2fa.png": "1df5ba12c2de318f858c36a3804b7170844cb74bdb73e1ea37895d674208b9e0", "images/blog/announcing-appwrite-arena/cover.png": "3934fbf6ee24c468b715b1839bc49c335a47a68f7fc99a763b109b2446f97379", + "images/blog/announcing-appwrite-claude-code-plugin/cover.png": "334e890b32c20c3a4c7f0878b5908a71a518d983b15b6ee434f9dabb66ee8ecd", "images/blog/announcing-appwrite-cursor-plugin/cover.png": "1a2dffe9876e72c571f24e46990b203b450b389afb0f0cf125fbd0e7eca4831c", "images/blog/announcing-appwrite-daily-dot-dev-squad/daily.dev-squad.png": "c69fdc687770e5562097fb30bf3f82ba54d7208faae9805faf3677480ba73857", "images/blog/announcing-appwrite-databases-new-ui/cover.png": "9318e0034f7c069246429429c08cc9f87032c34ad040c1f05f75449c4f28ffe9", @@ -1324,6 +1325,7 @@ "images/docs/mcp/bolt/bolt-mcp-settings.png": "cf29fc3f9490047eef9758f5c5d24f75148e40fa40bd05de8e6df754a5eae384", "images/docs/mcp/bolt/light/bolt-add-mcp.png": "1b6a5910cf3ff34f239acc03221042101979a8688bccde47f25aba87751c7c7e", "images/docs/mcp/bolt/light/bolt-mcp-settings.png": "1dea0c117e29421a7d32966923bdfbba7dfb8d8bcc825a813329c2ac8d0fc1c3", + "images/docs/mcp/claude-code/configure-plugin.png": "6f089ec25a250408dec84e2986681237d29c7ac382740857f155db20b60cc7d8", "images/docs/mcp/claude-code/implement-file-uploads.png": "6e8e6d9b49d5d74d2774ddb332323de608ad0e9ebbef2fdbf3e43644af5cc55a", "images/docs/mcp/claude-code/verify-mcp-tools.png": "7dad588fb8a57e767b4bff323169bc7d99c385232cb6f13eda659e9b722c2984", "images/docs/mcp/claude-desktop/claude-list-users.png": "4567dac118c3744f5b7c00987165f9a10ac2a215463eb65ee172974d8f161dfd", diff --git a/src/routes/blog/post/announcing-appwrite-claude-code-plugin/+page.markdoc b/src/routes/blog/post/announcing-appwrite-claude-code-plugin/+page.markdoc new file mode 100644 index 0000000000..00c9f767ef --- /dev/null +++ b/src/routes/blog/post/announcing-appwrite-claude-code-plugin/+page.markdoc @@ -0,0 +1,49 @@ +--- +layout: post +title: "Introducing the Appwrite plugin for Claude Code: Skills and MCP servers in one install" +description: The Appwrite plugin for Claude Code bundles agent skills and MCP servers into a single install, so your Claude Code agent can build with Appwrite out of the box. +date: 2026-04-20 +cover: /images/blog/announcing-appwrite-claude-code-plugin/cover.png +timeToRead: 4 +author: atharva +category: announcement +featured: false +--- + +Claude Code is built around a specific workflow: a terminal-resident agent that reads, writes, and runs code against your project. Using it with Appwrite has worked for a while, but getting there meant hand-registering MCP servers with `claude mcp add-json`, pasting your project credentials into a JSON payload, and relying on whatever SDK knowledge the underlying model was trained on. + +Today, we are announcing the **Appwrite plugin for Claude Code**. Two commands and your agent is set up to build with Appwrite using up-to-date SDK patterns and live access to your project. + +# What installing the plugin gives you + +The plugin ships three things in a single install: + +- **The Appwrite API MCP server:** Pre-registered with Claude Code. You configure your endpoint, project ID, and API key through the plugins menu instead of a JSON payload. +- **The Appwrite Docs MCP server:** No credentials required. Your agent can look up Appwrite's current documentation as it works, rather than relying on what the model was trained on. +- **Eleven agent skills:** Written as Markdown files for the Appwrite CLI and every major Appwrite SDK: TypeScript, Dart, .NET, Go, Kotlin, PHP, Python, Ruby, Rust, and Swift. Claude Code loads the relevant skill on its own when a task calls for it. + +# Setup the plugin + +In your terminal, run: + +```bash +claude plugins marketplace add appwrite/claude-plugin +claude plugins install appwrite@appwrite +``` + +Then run Claude Code, enter `/plugins`, move to the **Installed** tab, open **Appwrite**, and select **Configure options**. Enter your endpoint, project ID, and API key. Run `/reload-plugins` to apply the changes to your current session. + +# A prompt to try first + +Once the plugin is active, try a prompt like: + +`Create a new user in my Appwrite project with the email abc@example.com.` + +The agent uses the API MCP server to create the user in your project directly, with no code written on your side. + +# Resources + +- [Claude Code plugin docs](/docs/tooling/ai/ai-dev-tools/claude-code) +- [Plugin source code on GitHub](https://github.com/appwrite/claude-plugin) +- [Appwrite Skills](/docs/tooling/ai/skills) +- [Discord community](https://appwrite.io/discord) diff --git a/src/routes/changelog/(entries)/2026-04-20.markdoc b/src/routes/changelog/(entries)/2026-04-20.markdoc new file mode 100644 index 0000000000..65357d1397 --- /dev/null +++ b/src/routes/changelog/(entries)/2026-04-20.markdoc @@ -0,0 +1,12 @@ +--- +layout: changelog +title: "Appwrite plugin for Claude Code" +date: 2026-04-20 +cover: /images/blog/announcing-appwrite-claude-code-plugin/cover.png +--- + +The Appwrite plugin is now available for Claude Code. Install it to get agent skills for the Appwrite CLI and every major SDK, along with MCP servers for the Appwrite API and documentation, all in a single setup. + +{% arrow_link href="/blog/post/announcing-appwrite-claude-code-plugin" %} +Read the announcement +{% /arrow_link %} diff --git a/src/routes/docs/tooling/ai/ai-dev-tools/claude-code/+page.markdoc b/src/routes/docs/tooling/ai/ai-dev-tools/claude-code/+page.markdoc index 6b8a5cef6e..3e217d5977 100644 --- a/src/routes/docs/tooling/ai/ai-dev-tools/claude-code/+page.markdoc +++ b/src/routes/docs/tooling/ai/ai-dev-tools/claude-code/+page.markdoc @@ -1,10 +1,45 @@ --- layout: article title: Claude Code -description: Learn how you can use Claude Code with Appwrite using quick start prompts for common integrations and MCP servers to interact with both the Appwrite API and documentation. +description: Learn how to use Claude Code with Appwrite through the Appwrite plugin, quick start prompts, and MCP servers for AI-assisted development. --- -{% section #quick-start-prompts step=1 title="Quick start prompts" %} +{% section #install-plugin step=1 title="Install the Appwrite plugin" %} + +The fastest way to get started with Appwrite in Claude Code is to install the **Appwrite plugin** from the Appwrite marketplace. The plugin includes agent skills for the CLI and all major SDKs and sets up MCP servers for both the Appwrite API and documentation, giving Claude Code everything it needs to work with your Appwrite projects. + +To install the plugin, run the following commands in your terminal: + +```bash +# Add the marketplace +claude plugins marketplace add appwrite/claude-plugin + +# Install the plugin +claude plugins install appwrite@appwrite + +``` + +Once installed, run Claude Code and configure the plugin: + +- Run `/plugins` in Claude Code. +- Go to the **Installed** tab. +- Select the **Appwrite** plugin from the list. +- Choose **Configure options**. +- Enter your Appwrite endpoint, project ID, and API key when prompted. + +![Configure the Appwrite plugin in Claude Code](/images/docs/mcp/claude-code/configure-plugin.png) + +After saving the configuration, run `/reload-plugins` to apply the changes to your current session. The `appwrite-api` MCP server will be ready alongside the agent skills, and Claude Code can now interact with your Appwrite project. + +{% info title="Prefer manual setup?" %} + +If you'd rather configure MCP servers individually, skip to [Step 3](#step-3). + +{% /info %} + +{% /section %} + +{% section #quick-start-prompts step=2 title="Quick start prompts" %} Get started quickly with these pre-built prompts for common Appwrite integrations: @@ -21,7 +56,9 @@ Browse all quick start prompts {% /section %} -{% section #step-2 step=2 title="Add MCP servers" %} +{% section #step-3 step=3 title="Add MCP servers manually" %} + +If you installed the Appwrite plugin in [Step 1](#install-plugin), MCP servers are already configured and you can skip to [Step 4](#step-4). Connect Appwrite MCP servers to Claude Code for deeper integration with the Appwrite API and documentation. @@ -65,7 +102,7 @@ claude mcp add appwrite-docs -t http {% /section %} -{% section #step-3 step=3 title="Verify MCP tools" %} +{% section #step-4 step=4 title="Verify MCP tools" %} Run the following command in your terminal (where Claude Code is running). @@ -80,7 +117,7 @@ You should see the added MCP servers listed there. {% /section %} -{% section #step-4 step=4 title="Test the integration" %} +{% section #step-5 step=5 title="Test the integration" %} Try out the following example prompts based on the MCP server you have configured: @@ -113,4 +150,4 @@ Try out the following example prompts based on the MCP server you have configure ![Implement file uploads](/images/docs/mcp/claude-code/implement-file-uploads.png) -{% /section %} \ No newline at end of file +{% /section %} diff --git a/static/images/blog/announcing-appwrite-claude-code-plugin/cover.png b/static/images/blog/announcing-appwrite-claude-code-plugin/cover.png new file mode 100644 index 0000000000..fb70c90abd Binary files /dev/null and b/static/images/blog/announcing-appwrite-claude-code-plugin/cover.png differ diff --git a/static/images/docs/mcp/claude-code/configure-plugin.png b/static/images/docs/mcp/claude-code/configure-plugin.png new file mode 100644 index 0000000000..0e8f0694bd Binary files /dev/null and b/static/images/docs/mcp/claude-code/configure-plugin.png differ