Skip to content
This repository was archived by the owner on Sep 21, 2026. It is now read-only.
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
8 changes: 8 additions & 0 deletions src/routes/docs/tooling/ai/agents/claude-code/+page.markdoc
Original file line number Diff line number Diff line change
Expand Up @@ -33,6 +33,14 @@ claude mcp add --transport http appwrite https://mcp.appwrite.io/

The server uses OAuth for authentication. Run `/mcp` in Claude Code, select **appwrite**, and choose **Authenticate**. Your browser opens so you can sign in to your Appwrite account and authorize access.

If you run Claude Code on a remote host, log in from the shell with `--no-browser`:

```bash
claude mcp login appwrite --no-browser
```

Open the printed authorization URL in a browser on your local machine, sign in, and authorize access. After you approve, copy the full `http://localhost:.../callback` URL from the address bar and paste it into the Claude Code prompt. Use an interactive SSH session (`ssh -t`) so the prompt can accept the paste. This is the same localhost-callback pattern described in [Authenticate from a remote machine](/docs/tooling/ai/mcp-servers/api#remote).

{% /section %}

{% section #step-3 step=3 title="Verify MCP tools" %}
Expand Down
14 changes: 14 additions & 0 deletions src/routes/docs/tooling/ai/mcp-servers/api/+page.markdoc
Original file line number Diff line number Diff line change
Expand Up @@ -25,6 +25,8 @@ https://mcp.appwrite.io/

The server uses OAuth for authentication. When you add the server to an AI tool and connect for the first time, your browser opens so you can sign in to your Appwrite account and authorize access. You don't need to create or manage API keys.

MCP clients complete that OAuth flow with a localhost callback URL. If you run your AI tool on a remote host, follow [Authenticate from a remote machine](#remote).

# Pre-requisites {% #pre-requisites %}

Before connecting to the MCP server, you must [set up an Appwrite project](https://cloud.appwrite.io) on Appwrite Cloud. No additional software needs to be installed on your system.
Expand All @@ -44,6 +46,18 @@ The MCP server starts in a compact workflow where only a small set of MCP tools

The full Appwrite tool catalog stays internal and is searched at runtime, using less of the model's context.

# Authenticate from a remote machine {% #remote %}

MCP clients listen on a localhost callback URL for the OAuth redirect. When the client runs over SSH, on a droplet, or on any host without a local browser, that callback stays on the remote machine's loopback.

Log in from the [Claude Code](/docs/tooling/ai/agents/claude-code) shell with `--no-browser`:

```bash
claude mcp login appwrite --no-browser
```

The command prints an authorization URL. Open it in a browser on your local machine, sign in to Appwrite, and authorize access. After you approve, the browser navigates to a `http://localhost:.../callback` URL. Copy the full URL from the address bar and paste it into the Claude Code prompt.

# Self-hosted Appwrite {% #self-hosted %}

The hosted MCP server authenticates against Appwrite Cloud. If you are running a [self-hosted Appwrite instance](/docs/advanced/self-hosting), use the local MCP server instead. It runs on your machine over the stdio transport and connects to your instance with an API key. Follow the [self-hosted MCP server documentation](/docs/advanced/self-hosting/mcp) to set it up.
Expand Down
Loading