AIエージェントを接続する

任意のAIエージェントに一文を渡すだけで、mindzieStudioで作業できます。 Claude Cowork、Claude Code、Codex、Cursorなど：プロジェクトやユーザーの設定、データの読み込み、AI Process IntelligenceやBPM Studioでの作業を、すべて自然言語の指示で実行します。

https://docs.mindziestudio.com/agent.txt を読み、私のmindzieStudioアカウントに接続してください。

この文章だけを渡します。ページはエージェント向けに書かれており、エージェントはどのmindzieStudioにサインインして何をしたいかを尋ね、接続方法を判断し、キーの作成場所を教えます。キーは会話には一切含まれません： エージェントのコネクター設定か、エージェントがブラウザで開くページに入力します。

エージェントができること、必要なもの

エージェントにしてほしいこと	使用可能なエージェント	必要なキー
mindzieStudioで作業する: プロジェクト作成、ユーザー追加とアクセス権設定、データ読み込み	Claude Coworkやclaude.aiを含む任意のエージェント	テナントキー
AI Process IntelligenceとBPM Studioで作業する: プロジェクト作成・開始・停止、データ読み込み、プロジェクト内操作、AIレポート・スケジュール・アラート作成、図編集	全機能どのエージェントでも可能：Claude Coworkやclaude.aiはホストされたMCPサーバー経由、 Claude CodeやCodexなどコマンド実行可能なエージェントは`mz`ツールまたはホストサーバー経由	テナントキー
他社のテナントを作成する	任意のエージェント	グローバルキー：サーバー管理者およびパートナーのみ

文章の裏側には2つの接続方法があり、エージェントが自動で選択します：すべてのmindzieStudioサーバーで動作するホストされたMCPサーバー（インストール不要）と、コマンド実行型エージェントが自身でインストールする**mzツール**。選択は不要です。mzの詳細はConnect Your Own Agentを参照してください。

あなたのキー

上記のすべてをまかなうテナントキーが1つあれば十分です。mindzieStudioで、名前のメニューから管理 > 設定 > APIキーを開き、新しいシークレットキーを作成をクリックしてください。テナントの管理者ロールが必要です。キーは一度だけ表示されるので、すぐコピーしてください。

グローバルAPIキーはサーバー上の全テナントにアクセスでき、新しいテナント作成も可能です。サーバー管理者だけが作成可能（名前メニュー下のサーバー設定 > グローバルAPIキー）、テナントを顧客のためにセットアップするパートナーのみが必要です。Setting Up a Customer in One Step参照。

ホストされたMCPサーバーの手動セットアップ

エージェントが自動で案内しますが、ここでは自分で行いたい方向けに説明します。

URL

サーバー	MCP URL
mindzieStudio（米国）	`https://www.mindziestudio.com/mcp`
mindzieStudio Europe	`https://europe.mindziestudio.com/mcp`
自前のサーバー	`https://<your server>/mcp`

キーの渡し方は2通りあります：

エージェントができること	入力内容
URLのヘッダーで送信可能（Claude Cowork、Claude Code、Cursor、VS Code、エージェントAPI）	URL:`https://www.mindziestudio.com/mcp`、ヘッダー:`Authorization: Bearer <your API key>`
URLのみ受け付ける	`https://www.mindziestudio.com/mcp/k/<your API key>`

2番目の形式はパスワード扱いにしてください。 キーがURLに含まれるため、URLを見た人はキーを使えます。共有ドキュメントやチャットに貼り付けないでください。漏洩した場合はmindzieStudioでキーを削除し、新規作成してください。

エージェントへの設定

Claude Cowork / Claudeデスクトップアプリ

設定 > コネクター（claude.aiではカスタマイズ > コネクター）を開き、追加 → カスタムコネクターを追加を選びます。コネクターはあなたのClaudeアカウントに属し、Cowork、デスクトップアプリ、claude.aiで共有されます。
名前をmindzieにし、URLにhttps://www.mindziestudio.com/mcpを入力します。
認証でサインイン不要を選択。初めにClaudeは「今すぐサインイン」を推奨しますが、mindzieStudioはAPIキーを使い、認証ヘッダーはサインイン不要選択時のみ追加できます。
リクエストヘッダーにauthorizationをキー、Bearer <your API key>（"Bearer"＋半角スペース＋キー）を値として追加します。
保存。Claudeがmindzieツールを一覧表示します。新しい会話を始め、「mindzieを使って、私は誰として接続されていますか？」と聞いてみてください。ツール呼び出し前に許可を求められます。

ヘッダーオプションがない場合はURLをhttps://www.mindziestudio.com/mcp/k/<your API key>に変更してください。

Claude Code

claude mcp add --transport http mindzie https://www.mindziestudio.com/mcp --header "Authorization: Bearer <your API key>"

Cursor / VS Code

MCP構成ファイル（.cursor/mcp.jsonまたは.vscode/mcp.json）に以下を追加：

{
  "mcpServers": {
    "mindzie": {
      "url": "https://www.mindziestudio.com/mcp",
      "headers": { "Authorization": "Bearer <your API key>" }
    }
  }
}

Grok、OpenAI等のエージェントAPI

リモートMCPサーバーをサポートするAPIはサーバーURLと認証値を取ります。URLにhttps://www.mindziestudio.com/mcp、認証にBearer <your API key>を使います。URLのみの場合は/mcp/k/<your API key>形式を使用。

接続確認

エージェントにmindzie_whoamiを実行させてください。接続したサーバーと、キーがグローバルか（canManageTenants: true）、または特定テナント限定か（keyTenantId：開いているテナント）が返答されます。

一度の操作で顧客セットアップ

グローバルAPIキーが必要で、顧客向けにテナントを作成するパートナー向けです。テナントキーの場合は自身テナントで作業します。

mindzie_provision_tenantツールは以下をまとめて一度の呼び出しで行います：

テナント作成、
モジュール設定のON/OFF（Process Mining、Data Designer、BPM Studio、AI Process Intelligence）、
管理者ユーザー権限付与（既存アカウント再利用または新規作成）、
プロジェクト作成（管理者がオーナー、管理者はすぐ見える状態）。

例文：

mindzieを使い、テナント名acme-corp、表示名「Acme Corporation」、5ユーザーと2アナリストを設定。Process MiningとData DesignerをON、BPM StudioとAI Process IntelligenceをOFF。管理者はjane@acme.com（Jane Smith）。プロジェクトは「Purchase to Pay」と「Order to Cash」を作成。

メールは送信されません。 新規管理者アカウントにパスワードはなく、管理者はサインインページのパスワードを忘れた場合から設定するか、任意設定したパスワードを教えます。

複数顧客まとめて

会社名・管理者メール・モジュール一覧（例：スプレッドシート）を渡し、エージェントに一つずつセットアップ・結果報告させることが可能です。途中で停止した場合はresumeExistingを使って既存顧客のステップを省略し、再実行してください。既存はexistingとして報告され、重複処理されません。

データの読み込み

CSVファイルへのHTTPSリンク（最大1GB、例：読み取りトークン付きクラウドストレージリンク）をmindzie_upload_dataset_from_urlで指定してください。mindzieStudioサーバーが直接ダウンロードするため、大容量ファイルがチャットを通ることはありません。リンクは公開アクセス可能である必要があり、プライベートや内部ネットワークのリンクは拒否されます。

数千行程度ならCSVテキストをmindzie_upload_dataset_csv_textに貼り付けても構いません。

利用可能なツール

ツール	機能	必要なキー
`mindzie_whoami`	サーバーとキー情報	どれでも可
`mindzie_provision_tenant`	テナント・モジュール・管理者・プロジェクトを一括設定	グローバルキー
`mindzie_list_projects`, `mindzie_get_project`, `mindzie_create_project`, `mindzie_update_project`, `mindzie_delete_project`	mindzieStudioのプロジェクト操作	グローバルまたはテナントキー
`mindzie_list_project_members`, `mindzie_add_project_member`	プロジェクトの閲覧者管理	グローバルまたはテナントキー
`mindzie_list_datasets`, `mindzie_upload_dataset_csv_text`, `mindzie_upload_dataset_from_url`	データセット操作	グローバルまたはテナントキー

これらとは別に、サーバーはmzコマンドラインと同じツール群を提供し、同一仕様から生成されているため差異はありません。コマンド群はmethodとparamsで呼び出し、describeでパラメータ一覧を取得できます。

ツール	機能	必要なキー
`projects`, `projects_backups`, `projects_keys`, `projects_reports`	AI Process Intelligenceプロジェクトの作成・開始・停止・名前変更・サイズ変更・削除・ファイルからのインポート、バックアップと復元、公開レポート再実行	テナントキー
`cube_log`, `cube_files`, `cube_data`, `cube_eventlogs`, `cube_schema`, `cube_build`, `cube_filters`, `cube_enrichments`, `cube_rules`, `cube_calendar`, `cube_costs`, `cube_jobs`, `cube_reports`, `cube_schedules`, `cube_alerts`, `cube_styles` 他多数	1つのプロジェクトキューブ内の操作：データアップロード・読込、イベントログ照会、フィルター・エンリッチメント・ルール設定、スキーマ、AIレポートジョブ、公開レポート、スケジュール、アラート。各メソッドには`pi_project_id`が必要で、プロジェクトが実行中であることが条件	テナントキー
`bpmn_diagrams`, `bpmn_comments`, `bpmn_approvals`, `bpmn_audit`, `bpmn_ai`, `bpmn_ai_files`	BPM Studio：モデル、リビジョン、コメント、承認、監査ログ、画像やSOPからのAI調査	テナントキー、または`tenant_id`指定のグローバルキー
`studio_projects`, `studio_projects_members`	BPM Studioで扱うプロジェクトおよびメンバー	テナントキー、または`tenant_id`指定のグローバルキー
`tenants`, `tenants_settings`, `users`, `users_tenant`	テナント、設定、モジュール、ユーザー管理	グローバルキー

削除操作は対象の完全な名前を指定する必要があります。AI作業（AIレポート生成、レポートの再実行、BPM StudioのAI調査）はテナントのAIクレジットを消費します。

すべてのツールはREST APIとまったく同じルールに従います：同一の権限、バリデーション、エラーメッセージです。

知っておくと良いこと

素のテナントはサーバーのデフォルトモジュールを持ちます。 顧客の期待と異なる場合があります。mindzie_provision_tenantを使うか、tenants_settingsのupdateで明示的にモジュールを設定してください。
プロジェクトはメンバーのみ閲覧可能。 mindzie_create_projectで作成しただけではメンバー不在。mindzie_add_project_memberで追加してください。mindzie_provision_tenantはこの処理を行います。
削除は不可逆です。 優良なエージェントは削除前に確認します。削除ツールには正確な名前の指定が必要です。
すべてのツール呼び出しはサーバーでAPIキー名とともにログ記録されます。

トラブルシューティング

発生していること	原因	対処法
HTTP 401 / 「unauthorized」接続時	キーが間違い、削除済み、または別サーバー用（各地域固有）	接続先サーバーでキーを新規作成
「Global API keyが必要」	テナントキーでテナント横断ツールを利用（テナント管理、設定変更など）	これらはサーバー管理者・パートナー用。一般は自分テナント内ツールを使用。テナント作成するなら一括セットアップ参照
「TENANT API keyで実行すべきで、グローバルではない」	Process Intelligenceや`cube_`ツールでグローバルキー利用	対象プロジェクトのテナントでテナントキーを作成し接続
「テナントアクセス権なし」	キーのテナントと異なるテナントID指定	`mindzie_whoami`の`keyTenantId`を使用
管理者ログイン後、プロジェクトが見えない	プロジェクトのメンバーではない	`mindzie_add_project_member`で追加、または`mindzie_provision_tenant`でセットアップ
一括セットアップで「既に存在」エラー	テナント名が重複	同一顧客なら`resumeExisting`で再実行。別の場合は別名を選択
データの読み込み時に「非公開アドレス」	プライベートまたは内部ネットワークへのリンクを指定	公開可能なhttpsリンクを使用