CC for Biz
2026/03/28Claude Code
AI活用導入・運用

Claude CodeでSupabase MCPを使う設定と実例

Claude CodeでSupabase MCPを使う設定と実例

「Claude CodeからSupabaseを操作したい」「MCPでつなぐと何ができて、何に気をつければいいのか」——Claude Codeで開発や業務の自動化を進めると、データベースとの連携で一度は手が止まります。

結論から言うと、Supabase MCPは公式のリモートサーバーをコマンド1行で追加し、ブラウザでログインするだけでつながります。安全に使う要点は、読み取り専用にすることと、つなぐプロジェクトを1つに絞ることの2つです。

株式会社Fyveは、Claude Codeに外部サービスをMCPでつなぎ、記事の投稿や開発中のデータベースの確認に使っています。この記事では、Supabase MCPの設定手順と安全な使い方を公式の手順に沿って整理し、microCMSとつないでいる実例もあわせて紹介します。

MCPとは——Claude Codeを外部サービスと繋げるプロトコル

Claude Codeは単体でも強力ですが、MicroCMSやSupabaseなどの外部サービスと連携すると業務自動化の幅が一気に広がります。この連携を実現するのがMCP(Model Context Protocol)です。

MCPはAnthropicが策定したオープンプロトコルで、AIアシスタントと外部のデータソースやツールを標準化された方法で接続するための仕組みです。一言で言えば、Claude Codeに「外部サービスのAPIを直接操作する能力」を追加するものです。

MCPの役割

MCPの仕組み

MCPはクライアント—サーバーモデルで動作します。Claude Code(クライアント)がMCPサーバーに接続し、サーバーが提供するツール(API操作)を使えるようになります。

MCPサーバーが提供するもの

  • ツール(Tools): 「記事を投稿する」「データベースにクエリを実行する」などの操作
  • リソース(Resources): 外部サービスから取得したデータ(記事一覧、テーブル構造など)
  • プロンプト(Prompts): サーバー側が定義したプロンプトテンプレート

重要なのは、MCPがオープンな標準規格だという点です。Anthropic以外のサービスやコミュニティも自由にMCPサーバーを作成でき、実際にMicroCMS、Supabase、GitHub、Slack、Google Driveなど多数のサービスが公式・非公式のMCPサーバーを提供しています。

この記事を読んでいるあなたへ無料プレゼントClaude Codeを「素のまま」使うな設定で差がつく——CLAUDE.md・権限・スキルの実物を公開(全24ページ)
そのまま書き換えて使えるCLAUDE.mdの型お金と送信をAIに触らせない「3段階の柵」1回教えたら何度でも動く、手順書のコピペ雛形
中身のプレビューを見る ↓登録すると、過去の特典もまとめて受け取れます(PDF 23点・合計550ページ + すぐ使えるzip素材 3点)

MCPの設定方法

MCPサーバーの追加は、Claude Codeのコマンド一つで完了します。

claude mcp add microcms -- npx -y @microcms/mcp-server \
  --service-id your-service-id \
  --api-key your-api-key

設定は.mcp.json(プロジェクトごと)または~/.claude.json(ユーザーごと)に保存されます。一度設定すれば、以降のセッションで自動的にMCPサーバーが起動し、Claude Codeから直接外部サービスのAPIを呼び出せます。

Claude CodeにSupabase MCPをつなぐ手順

Supabaseは、MCPサーバーを公式に提供しています。2026年10月19日時点の公式の手順では、Supabaseが用意しているリモートのMCPサーバーにHTTPでつなぎます。

1. コマンドで追加する

Claude Codeを開くフォルダで、次のコマンドを実行します。

claude mcp add --scope project --transport http supabase "https://mcp.supabase.com/mcp"

--scope は、設定をどこに保存するかの指定です。project はそのフォルダの .mcp.json に保存し、Gitで共有できます(初めて使うときに承認を求められます)。自分だけで使うなら、既定の local か、全プロジェクト共通の user を選びます。

2. ブラウザでログインする

Claude Codeの中で /mcp を開き、supabase を選んで「Authenticate」を押すと、ブラウザでSupabaseへのログインと許可の画面が開きます。公式の案内では、個人用のアクセストークンを作る必要はありません(CIのように人がログインできない場所では、権限を絞ったトークンをヘッダーで渡す方法もあります)。/mcp で「Connected」と出れば完了です。

3. 読み取り専用にし、プロジェクトを1つに絞る

URLの末尾に条件を付けると、Supabase MCPにできることを絞れます。

  • read_only=true:読み取り専用のデータベースユーザーでSQLを実行します。誤ってデータを消したり書き換えたりできなくなります
  • project_ref=プロジェクトのID:1つのプロジェクトだけを操作の対象にします。プロジェクトの作成や一時停止など、アカウント全体に関わる操作は使えなくなります
  • features:使う機能のまとまり(データベース・ドキュメント検索など)だけを有効にします
claude mcp add --transport http supabase "https://mcp.supabase.com/mcp?project_ref=abc123&read_only=true"

(abc123 は自分のプロジェクトのIDに置き換えます)

4. 使える主な操作

  • データベース:テーブルの一覧、SQLの実行、マイグレーション(テーブルの構造の変更)の適用
  • 調査:ログの確認、セキュリティや性能についての指摘(advisors)の取得
  • 開発:プロジェクトのURLや公開用のキーの取得、TypeScriptの型の生成
  • そのほか:Edge Functionsの一覧・取得・デプロイ、Supabaseのドキュメントの検索

Supabaseが勧めている安全な使い方

Supabaseの公式の案内では、次の使い方を勧めています。

  • 本番のデータベースには、本番の情報がどうしても必要な作業のときだけつなぐ。普段は開発用のプロジェクトにつなぐ
  • データベースの中身に、AIへの指示に見える文章が紛れ込む攻撃(プロンプトインジェクション)があるため、対話で使うときは、操作のたびに承認する設定のままにする
  • 人が見ていない自動の処理では、プロジェクトを1つに絞り、読み取り専用の操作だけを事前に許可する
  • 開発者の権限で動くので、顧客や社外の人が使う仕組みには組み込まない

(出典:Supabase「Model context protocol (MCP)」supabase.com/docs/guides/getting-started/mcp/Anthropic「Connect Claude Code to tools via MCP」code.claude.com/docs/en/mcp・2026年10月19日確認)

実務でのMCP活用事例

1. MicroCMS連携——記事投稿の完全自動化

私が最も活用しているMCP連携です。Claude CodeにMicroCMSのMCPサーバーを接続し、記事の執筆からCMS投稿までを一気通貫で自動化しています。

具体的なフローは、キーワード調査→記事執筆(HTML)→サムネイル画像生成→MicroCMSへの下書き投稿。この一連の作業をClaude Codeが一度の指示で完了します。MCPがなければ、記事を書いた後に手動でMicroCMSの管理画面を開き、コピー&ペーストする必要がありました。

2. Supabase連携——データベース操作

SupabaseのMCPサーバーを接続すると、Claude Codeからデータベースの構造確認・クエリ実行・マイグレーションが可能になります。開発中に「このテーブルの構造を確認して」「このクエリを実行して結果を見せて」と自然言語で指示するだけで、Claude CodeがSQLを生成して実行してくれます。設定の手順と安全な使い方は、上の「Claude CodeにSupabase MCPをつなぐ手順」にまとめています。

3. デザイン系MCPを外した判断

以前はStitchやPencilといったデザイン系のMCPサーバーも接続していました。しかし運用する中で、プロンプトやSkillsでデザインガイドラインを定義し、コード上でデザインを整える方がトータルの作業コストが下がると判断し、現在はデザイン系MCPは外しています。

MCPは「使えるから使う」ではなく、「使った方が本当に効率的か」を判断して取捨選択することが重要です。

MCP連携の実例

MCP運用のセキュリティ判断

MCPは常にAPI経由で外部サービスと情報をやり取りするため、情報漏洩のリスクは常にあります。便利だからといって無条件に接続するのは危険です。

MCP接続時に確認すべき3つの観点

  • 本当に必要か: そのMCPサーバーがないと業務が回らないのか。手動でも問題ない頻度なら接続しない
  • 水際のセキュリティ対策が取れるか: APIキーの管理、アクセス権限の最小化、ログの記録ができるか
  • 使用していないMCPが残っていないか: 不要なMCPを許可状態にしておくことはセキュリティ的にメリットがない。使わなくなったら外す

私の運用では、プロジェクトごとに.mcp.jsonを分けて管理し、そのプロジェクトで本当に必要なMCPサーバーだけを接続しています。クライアント案件で機密性が高い場合は、MCP接続自体を最小限にするか、開発フェーズが終わったら外すことも検討します。

MCP接続のセキュリティ判断

まとめ:MCPはClaude Codeの「手足」を増やす

MCPを使うことで、Claude Codeは単なるコーディングツールから外部サービスを直接操作できる業務自動化エージェントに進化します。

  • オープンプロトコルで多数のサービスが対応済み
  • claude mcp addコマンド一つで設定完了
  • MicroCMS、Supabase等との連携で記事投稿・DB操作を自動化
  • 「使えるから使う」ではなく、効率とセキュリティの観点で取捨選択する

MCPと組み合わせて業務フローを自動化するSkillsについては、こちらの記事で詳しく解説しています。

Claude Code Skillsの作り方と使い方|業務自動化の実践ガイド【2026年版】
Claude CodeClaude Code Skillsの作り方と使い方|業務自動化の実践ガイド【2026年版】

Claude Codeのセキュリティ設定(Hooks・Permissions)についてはこちらをご覧ください。

Claude Code Hooksとは?品質チェック自動化の実践法
Claude CodeClaude Code Hooksとは?品質チェック自動化の実践法

Claude Code全体の使い方を知りたい方はこちらの記事がおすすめです。

【実務者が解説】Claude Codeの使い方ガイド|非エンジニアでも業務活用できる方法
Claude Code【実務者が解説】Claude Codeの使い方ガイド|非エンジニアでも業務活用できる方法
この記事を読んでいるあなたへ無料プレゼント

Claude Codeを「素のまま」使うな

設定で差がつく——CLAUDE.md・権限・スキルの実物を公開(全24ページ)

素のClaude Codeは"優秀な新入社員"。仕事を教えるほど、自分専用になります。覚えさせる4点セット——会社の説明書(CLAUDE.md)・権限の柵・手順書(スキル)・フォルダの地図——を、1人会社の実運用からコピペで使える型つきで公開します。

  • そのまま書き換えて使えるCLAUDE.mdの型
  • お金と送信をAIに触らせない「3段階の柵」
  • 1回教えたら何度でも動く、手順書のコピペ雛形
  • AIが迷子にならないフォルダ構造の3原則

メールアドレス登録で他にも様々な資料を閲覧できます

Claudeのプランを「上げる」前に読む本AIっぽくない画像を生成するためのプロンプトギャラリー10選「Muse」の便利な使い方 TOP30「Fable 5.2」vs「Opus 5.5」徹底比較「GPT-6.1 Terra」を、実務で比べてみた。仕事でAIを使う人が「絶対に」知っておくべき Claude Codeスキル TOP10「Sonnet 5.5」を、実務で比べてみた。Codexを使い始める前に、「絶対に」見直してほしい5つのこと「Opus 5.5」を、実務で比べてみた。+14

PDF 23点・合計550ページ + すぐ使えるzip素材 3点

どれも登録後の受け取りページから、まとめてダウンロードできます。

毎週配信の無料ニュースレター「AIネイティブ超研究」の購読特典です。メール登録後すぐ、受け取りページのご案内が届きます。そこにはこの資料に加えて、過去の特典もすべてまとめて置いてあります。あわせて、AI活用に関するお知らせやお役に立てそうなご案内をお送りすることがあります。解除はいつでも1クリック。

← 記事一覧に戻る

御社の業務に合わせたClaude Code導入支援

「AIツールを導入したが、現場で使われない」を終わらせる。
業務課題のヒアリングから設計、ハンズオン実践、運用定着まで一貫して支援します。

無料AI活用診断を受ける料金とサービス一覧を見る →
© 2025 Fyve Inc. All rights reserved.