MCP Integration Guide

MinTo MCP リモートサーバー
設定・利用ガイド

Claude Code や Cursor などの AI エージェントに MinTo の MCP サーバーを接続し、
AI との対話を通じて直接 MinTo を操作できるようにする手順を解説します。

ポイント

MinTo の MCP サーバーは、JWT によって保護された StreamableHTTP(SSE通信) として提供されています。 ローカル環境だけでなく、ネットワーク経由で安全に接続することが可能です。

事前準備

接続に必要な情報はエンドポイント URL のみです。事前のログインは不要で、初回接続時にブラウザが自動的に開き、画面の案内に沿って認証するだけで完了します(OAuth 2.1)。

MCPエンドポイントURL:https://api.mintoai.net/mcp

⚙️クライアント別の設定手順

1
Claude Web (claude.ai) の場合

ブラウザ版の claude.ai では、設定画面からカスタムコネクタを追加することで MinTo MCP サーバーに接続できます。インストール不要で、Web ブラウザだけで設定が完結します。

設定手順
1

画面右上のプロフィールアイコンをクリックし、「カスタマイズ」を選択します。

プロフィールメニューから「カスタマイズ」を選択

▲ プロフィールメニューから「カスタマイズ」を選択

2

カスタマイズ画面が開いたら、「コネクタ」タブを選択します。

「コネクタ」タブを選択

▲ 「コネクタ」タブを選択

3

「カスタムコネクタを追加」ボタンをクリックします。

「カスタムコネクタを追加」ボタンをクリック

▲ 「カスタムコネクタを追加」をクリック

4

ポップアップが表示されたら、以下の値を入力して追加します。

カスタムコネクタ追加ポップアップ

▲ 入力フォームが表示される

コネクタ設定
名前: minto
URL: https://api.mintoai.net/mcp
名前とURLを入力した状態

▲ 名前に「minto」、URL に MinTo エンドポイントを入力

5

コネクタ一覧に MinTo が追加されたことを確認します。

コネクタ一覧に MinTo が追加された状態

▲ コネクタの追加が完了した状態

6

追加された MinTo の「MinTo と連携する」ボタンをクリックし、認証を開始します。

「MinTo と連携する」ボタンをクリック

▲ 「MinTo と連携する」をクリックして認証を開始

7

ブラウザに MinTo のログイン画面が表示されたら、画面の案内に沿って認証します。認証が完了するとチャット画面でツールが利用できるようになります。

連携完了後のチャット画面

▲ 連携完了。チャット画面でツールが利用可能になった状態

補足

初回接続時はブラウザに MinTo のログイン画面が自動的に表示されます。画面の案内に沿って MinTo アカウントでログインするだけで完了します(OAuth 2.1)。

認証の有効期限が切れた場合は、「カスタマイズ」>「コネクタ」からMinTo の「MinTo と連携する」ボタンを再度クリックして再認証してください。

2
Claude Code の場合

Claude Code では、CLI コマンドから直接リモートサーバーを追加するのが最も簡単です。

コマンドで追加する(推奨)

ターミナルで以下のコマンドを実行してください。

ターミナル
$ claude mcp add --transport http minto https://api.mintoai.net/mcp
設定ファイル(.mcp.json)を直接編集する場合

プロジェクトルートの .mcp.json に以下の設定を追記することでも連携可能です。

.mcp.json
{
  "mcpServers": {
    "minto": {
      "type": "http",
      "url": "https://api.mintoai.net/mcp"
    }
  }
}
3
Cursor の場合

Cursor は標準で HTTP 形式の MCP サーバー接続を UI からサポートしています。

設定手順
  1. Cursor の設定画面(Settings)を開く
  2. Features > MCP セクションに移動する
  3. + Add New MCP Server をクリックする
  4. 以下の値を入力する
Cursor MCP 設定
Name: minto
Type: http
URL : https://api.mintoai.net/mcp
4
Claude Desktop の場合

Claude Desktop(Mac/Windows アプリ)は、Remote MCP サーバーへの接続をサポートしています。 claude_desktop_config.json に以下の設定を追加してください。

設定ファイルの場所
ファイルパス
# macOS
~/Library/Application Support/Claude/claude_desktop_config.json

# Windows
%APPDATA%\Claude\claude_desktop_config.json
設定内容
claude_desktop_config.json
{
  "mcpServers": {
    "minto": {
      "type": "http",
      "url": "https://api.mintoai.net/mcp"
    }
  }
}
補足

設定後は Claude Desktop を再起動してください。MCP ツールが利用可能になると、チャット画面にツールアイコンが表示されます。

💬AIへの指示例(プロンプト例)

設定が完了したら、AI エージェントに対して以下のように話しかけることで MinTo の操作を代行させることができます。

🏢 「MinTo で自分が所属しているチームの一覧と、そこにあるサイトの一覧を取得して」
🌐 「MinTo に新しく my-awesome-site というサブドメインでサイトを作成してください」
🚀 「カレントディレクトリの dist フォルダを ZIP 化して、先ほど作成したサイトにデプロイして」
💳 「現在のサブスクリプションのプラン一覧を確認して」
🔒 「サイト my-site にベーシック認証を設定して、ユーザー名を admin にして」
📊 my-site の最新デプロイのステータスを確認して」

🔧トラブルシューティング

Q ツールの呼び出しが失敗する
サイト作成やデプロイなどの操作には owner_idteam_id が必要です。 AI がこれらの ID を把握していないとエラーになるため、まず「組織(Organizations)とチームの一覧を取得して ID を確認して」と AI に前提として指示することでスムーズに進みます。
Q MCP サーバーに接続できない
エンドポイント URL https://api.mintoai.net/mcp に誤りがないか確認してください。 初回接続時はブラウザが自動的に開いて認証画面が表示されます。画面の案内に沿って MinTo アカウントでログインすると、以降は自動的に認証が維持されます(OAuth 2.1)。
Q Claude Desktop でツールが表示されない
設定ファイルを保存後、Claude Desktop を完全に再起動してください。 起動後、チャット画面の入力欄付近にツールアイコンが表示されていれば接続成功です。 JSON の構文エラーがないか(カンマや括弧の漏れなど)も確認してください。

MinTo をまだ使っていない方へ

無料プランからすぐに始められます。AI に「MinTo でサイトを公開して」と頼んでみましょう。

無料で始める