mcp-for-api について
mcp-for-api は Appwrite の MCP サーバーで、データベース、ユーザー、関数、チーム、ストレージなどの API をツールとして MCP クライアントに公開します。Appwrite を利用する開発者を対象とし、ホスト型サーバーにはブラウザーの OAuth 認証で接続します。
主な機能
- 01ブラウザーの OAuth 認証によるホスト型サーバー
- 02データベース、ユーザー、関数、チーム、ストレージのツール
- 03セルフホスト型 Appwrite 向けのローカル stdio 実行
- 04組み込みのドキュメント検索ツール appwrite_search_docs
活用シーン
- 01AI クライアントからの Appwrite データベースとユーザーの管理
- 02コーディングセッション中の Appwrite 関数とストレージの呼び出し
MCP 対応
Appwrite API の操作を MCP クライアントから呼び出せるツールとして公開する MCP サーバーです。Claude Code、Cursor、VS Code、Codex など複数のクライアントの設定方法が記載されています。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
ツール
ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。
詳細
Appwrite MCP サーバー
Appwrite 用の Model Context Protocol サーバーです。 Appwrite の API(データベース、ユーザー、関数、チーム、ストレージなど)を、 MCP クライアントから呼び出せるツールとして公開します。
ホスト型サーバー https://mcp.appwrite.io/ に接続し、
ブラウザーから認証します。初回の接続時に、クライアントで Appwrite の
同意画面が開きます。スコープを承認すると接続できます。キーを
コピーする必要はありません。一般的な https://mcp.appwrite.io/mcp の URL も
サポートされており、同じサーバーに接続します。

クライアントを接続する
以下からクライアントを選択してください。どの方法でも、ホスト型 Appwrite Cloud サーバーが追加されます。
Claude Code
claude mcp add --transport http appwrite https://mcp.appwrite.io/
次に、Claude Code のセッション内で /mcp を実行し、appwrite を選択して、
ブラウザーに表示されるプロンプトに従って認証します。
Claude Desktop
Settings → Connectors → Add custom connector に移動し、
https://mcp.appwrite.io/ を貼り付けます。Pro および Max プランで利用できます。
Team および Enterprise プランでは、組織の Owner のみがカスタムコネクターを追加できます。
このオプションが表示されない場合(無料プラン、または Team/Enterprise のメンバーの場合)は、 代わりに stdio を介してリモートサーバーをブリッジしてください(Node.js が必要です)。Settings → Developer → Local MCP servers に移動し、 Edit Config をクリックして、次を追加します。
{
"mcpServers": {
"appwrite": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://mcp.appwrite.io/"]
}
}
}
Claude Desktop を再起動すると、サーバーが Local MCP servers に表示され、 認証用のブラウザーウィンドウが開きます。

Cursor
~/.cursor/mcp.json(グローバル)または .cursor/mcp.json(プロジェクト)を編集します。
{
"mcpServers": {
"appwrite": {
"url": "https://mcp.appwrite.io/"
}
}
}
Cursor からブラウザー経由でログインするよう求められます。その後、サーバーは Settings → MCP に表示され、ツールが有効になります。

VS Code(GitHub Copilot)
.vscode/mcp.json(ワークスペース)を編集するか、コマンド
パレット → MCP: Open User Configuration からユーザー設定を編集します。
{
"servers": {
"appwrite": {
"type": "http",
"url": "https://mcp.appwrite.io/"
}
}
}
Codex
~/.codex/config.toml を編集します。
[mcp_servers.appwrite]
url = "https://mcp.appwrite.io/"
次に、ターミナルから認証します。
codex mcp login appwrite
Codex GUI では、MCP 設定からサーバーを追加することもできます。
URL に https://mcp.appwrite.io/ を設定し、トークンとヘッダーの
フィールドは空のままにしてください(認証はブラウザー経由で行われます)。

OpenCode
opencode.json(プロジェクト)または ~/.config/opencode/opencode.json(グローバル)を編集します。
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"appwrite": {
"type": "remote",
"url": "https://mcp.appwrite.io/",
"enabled": true
}
}
}
Windsurf
~/.codeium/windsurf/mcp_config.json を編集します。
{
"mcpServers": {
"appwrite": {
"serverUrl": "https://mcp.appwrite.io/"
}
}
}
Gemini CLI
gemini mcp add --transport http appwrite https://mcp.appwrite.io/
または ~/.gemini/settings.json を編集します(キーは url ではなく httpUrl です)。
{
"mcpServers": {
"appwrite": {
"httpUrl": "https://mcp.appwrite.io/"
}
}
}
Gemini CLI は、初回の接続時にブラウザーでの OAuth フローを自動的に開始します。
再認証するには、セッション内で /mcp auth appwrite を実行します。
Antigravity(CLI & 2.0)
~/.gemini/config/mcp_config.json(グローバル)または .agents/mcp_config.json(プロジェクトのワークスペース)を編集します。
{
"mcpServers": {
"appwrite": {
"serverUrl": "https://mcp.appwrite.io/"
}
}
}
⚠️ 注意: Antigravity では、リモートトランスポートに
serverUrlキーが必須です。urlやhttpUrlなどの旧形式のフィールドを使用すると、ツールの登録が失敗してもエラーは表示されません。 初回接続時、Antigravity はブラウザーでの OAuth フローを自動的に開始します。JSON ファイルを手動で編集した場合は、Settings → Customizations → Installed MCP Servers に移動し、Refresh をクリックしてツール定義を再読み込みしてください。
GitHub Copilot CLI
copilot mcp add --transport http appwrite https://mcp.appwrite.io/
セッション内で /mcp add を実行するか、~/.copilot/mcp-config.json を編集することもできます。
{
"mcpServers": {
"appwrite": {
"type": "http",
"url": "https://mcp.appwrite.io/"
}
}
}
初回接続時に、認証用のブラウザーウィンドウが開きます。ステータスは
/mcp で確認できます。
Zed
Settings → AI → MCP Servers → Add Server → Add Remote Server に移動するか、
settings.json(zed: open settings)に追加します。
{
"context_servers": {
"appwrite": {
"url": "https://mcp.appwrite.io/"
}
}
}
初回接続時に、Zed からブラウザーでの認証を求められます。
Warp
Settings → Agents → MCP servers → + Add に移動し、URL ベースの
サーバータイプを選択して、https://mcp.appwrite.io/ を入力します。
初回接続時に、Warp で認証用のブラウザーウィンドウが開きます。
JetBrains AI Assistant / Junie
JetBrains IDE はリモート MCP サーバーの OAuth にまだ対応していないため、stdio 経由でブリッジしてください (Node.js が必要です)。Settings → Tools → AI Assistant → Model Context Protocol (MCP) → Add に移動し、JSON ビューに切り替えて、次を貼り付けます。
{
"mcpServers": {
"appwrite": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://mcp.appwrite.io/"]
}
}
}
初回接続時に、認証用のブラウザーウィンドウが開きます。
Cline
Cline はリモート MCP サーバーの OAuth にまだ対応していないため、stdio 経由でブリッジしてください (Node.js が必要です)。Cline パネルで、MCP Servers アイコン → Configure タブ → Configure MCP Servers を開き、次を追加します。
{
"mcpServers": {
"appwrite": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://mcp.appwrite.io/"]
}
}
}
初回接続時に、認証用のブラウザーウィンドウが開きます。
セルフホスト Appwrite
独自の Appwrite インスタンスを実行していますか?MCP サーバーをローカルで stdio 経由で実行し、
プロジェクト API キーで認証します。クライアントごとのセットアップについては、docs/self-hosted.md
を参照してください。
ドキュメント
- ツールの概要 — モデルに公開されるツールと Appwrite の内部カタログ。
- Cloud の認証の仕組み — OAuth 2.1 フロー。
- ドキュメント検索 — プロセス内の
appwrite_search_docsツールと、そのインデックスの再構築方法。 - イベント — MCP Events:Appwrite プロジェクトの変更に対する Webhook サブスクリプション (開発中で、まだ利用できません)。
- セルフホスト Appwrite — プロジェクト API キーを使ってサーバーをローカルで実行します。
- ローカル開発 — サーバーのローカルでの実行、テスト、デバッグ。
- AGENTS.md — 貢献者向けの完全なガイドと PR 前チェックリスト。
ライセンス
この MCP サーバーは MIT License の下でライセンスされています。詳細は LICENSE ファイルを 参照してください。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。