MateMCP

MateMCP

エージェントが制限に達しましたか？作業を続けましょう。

ウェブサイト： matemcp.com · アカウントポータル： api.matemcp.com · リリース： agent-latest

MateMCP を使えば、すでに料金を支払っている AI プランから、さらに有用な成果を得られます。プロバイダーに組み込まれたコーディングツールやエージェントツールが利用上限に達しても、AI チャット自体が引き続き利用可能な場合、MateMCP はその会話から、ご自身の Windows または macOS コンピューターへ制御された経路を提供します。これにより、実際のプロジェクトやツールで有用な作業を続けられます。

MateMCP はプロバイダーの利用上限を増やしたり、回避したりするものではありません。 ご自身のコンピューターとアクセスルールを使い、MCP 経由で作業する別の方法を、互換性のある AI クライアントに提供します。

お好きな AI をご利用ください。ChatGPT、Claude、Grok、または互換性のある別の MCP クライアントを、登録済みの MateMCP Agent に接続できます。Agent はプロジェクトファイル、シェル、ブラウザー、デスクトップアプリ、添付ファイル、シークレット、永続的なプロジェクトコンテキストを扱えます。その間、MateMCP はアクセス範囲を限定し、認証と可視性を確保し、承認に対応します。

公開ウェブサイトの matemcp.com は、製品の紹介とオンボーディングを担います。認証が必要なアカウントポータルの api.matemcp.com は、アカウントへのアクセス、登録済みデバイス、承認、管理を扱います。通常のデスクトップでの利用はシンプルです。MateMCP Desktop をインストールし、デバイスを登録して、MCP URL を AI クライアントにコピーし、OAuth で認証するだけです。Agent の認証情報をコピーしたり、ローカルポートをインターネットに公開したりする必要はありません。

MateMCP を選ぶ理由

• 組み込みエージェントが止まっても続けられます — チャットを引き続き利用できるなら、作業セッションを終わらせるのではなく、ご自身のツールへの制御された経路を提供します。
• すでに利用している AI プランを最大限に活用できます — MateMCP に AI プロバイダーの置き換えを求めることなく、性能の高いチャットを使って実際のローカル作業を行えます。
• お好きな AI を利用できます — ChatGPT、Claude、Grok、または互換性のある別の MCP クライアントを、同じローカル Agent モデルで使えます。
• 実際のコンピューターで作業できます — ファイル、シェル、ブラウザー、デスクトップアプリ、添付ファイル、プロジェクトコンテキストは、普段の作業場所にあります。
• 管理権限を維持できます — プロジェクトのスコープ、OAuth、承認、監査可能性、ローカルでのシークレット管理により、強力なアクセスを明示的に管理できます。

MateMCP でできること

• プロジェクト単位のファイルシステムアクセス — 設定したプロジェクト内のファイルだけを読み取り、変更できます。
• シェルと対話型ターミナルセッション — コマンドを実行し、長時間稼働するシェルを維持し、一時的な再接続後に出力を再開し、AI に開示することなく承認済みのシークレットを注入できます。
• Computer Use — スクリーンショットを確認し、ブラウザーやネイティブ UI を操作して、クリック、入力、スクロールを行い、対応している場合はセマンティックなアクセシビリティ操作を利用できます。
• ブラウザー自動化とビジュアル QA — アプリケーションを操作し、レスポンシブレイアウトを確認し、スクリーンショットを撮影して、フロントエンドやデスクトップの検証ワークフローを支援できます。
• 安全な添付ファイル転送 — 上限が設定され、中断後に再開でき、整合性が検証される転送を使って、会話のファイルを選択した Agent にアップロードできます。
• 承認 — 機密性の高い操作にローカルまたはリモートでの承認を必須にし、その判断を監査可能な状態に保てます。
• Secret Manager — ユーザーが管理する認証情報を、モデルコンテキストやプロジェクトファイルではなく、オペレーティングシステムの認証情報ストアに保存できます。
• アクティビティ、監査、診断 — Agent の動作を確認し、承認や認証情報のアクティビティを調べ、接続や実行の失敗を診断できます。
• スキルとメモリー — 複数のプロジェクトにまたがるグローバルな知識は Agent に保持し、プロジェクト固有の知識はバージョン管理されたリポジトリの SKILL.md ファイルに保存して、Git とともに持ち運べます。
• 複数デバイスからのアクセス — 1 つのアカウントに、個別に登録を取り消せる複数の Agent を登録できます。
• 安定した接続性 — Agent または Relay が短時間切断されても論理セッションは維持され、操作には安定した ID が使用され、対応するストリームや転送は安全に再開できます。

全体の仕組み

flowchart LR
    User[User / Admin]
    Site[Public website\nmatemcp.com]
    Portal[Account portal\napi.matemcp.com]
    AI[AI client\nChatGPT / Claude / Grok / MCP client]
    Relay[MateMCP Relay]
    API[OAuth Control Plane]
    Agent[Local MateMCP Agent]
    Companion[Companion]
    Machine[Projects · Shell · Browser · Desktop · Secrets]

    User --> Site
    User --> Portal
    Portal -->|account / devices / approvals / admin| API
    AI -->|OAuth + MCP| Relay
    AI -->|Authorize| API
    Relay <-->|resilient Agent channel| Agent
    Agent --> Machine
    Companion <-->|local management| Agent
    Companion -->|approvals / status / logs| Machine
    Relay -->|authorization checks| API

公開ウェブサイトでは、製品の説明やオンボーディングの開始方法を案内します。アカウントポータルは、アカウント、デバイス、承認、管理機能を扱うブラウザーベースのユーザー／管理者向け画面です。Relayは、リモート MCP トラフィックを適切なオンライン状態の Agent に転送します。Control Planeは、アカウント、Agent の所有権、OAuth、認可、リモート承認の調整を担います。Agentはローカルで作業を実行します。Companionでは、ステータス、承認、シェル、シークレット、アクティビティ、診断、更新、Agent のライフサイクル制御をネイティブな画面で確認できます。

信頼とセキュリティのモデル

MateMCP は、AI とユーザーのコンピューターの間に境界を設けるよう設計されており、ローカルのセキュリティを迂回するトンネルではありません。

• 各 Agent にはランダムな公開 ID と、それとは別の高エントロピーな秘密の認証情報があります。
• Agent の認証情報とユーザーが管理するシークレットは、macOS Keychain または Windows Credential Manager に保存されます。
• MCP URL は Agent を識別するものであり、それ自体が Agent の秘密の認証情報ではありません。
• OAuth トークンは、ユーザー、Agent／リソース、付与されたスコープに紐付けられます。アクセストークンは、ユーザーに繰り返し再接続を求めることなく更新できます。
• ファイルシステムへのアクセスは、設定されたプロジェクトルート内に限定されます。
• mcp:read、mcp:write、mcp:shell の機能は、URL から推測するのではなく、実際に適用されます。
• 機密性の高い操作では、明示的な承認を必須にできます。承認と認証情報の使用は監査可能です。
• Relay がユーザーの OS のシークレットを必要とすることはありません。
• 添付ファイルの転送は承認のうえで実行され、転送量が制限され、中断後に再開でき、オプションで SHA-256 検証も行われます。
• Agent と Relay の再接続では、安定したセッション／操作 ID を使用し、一時的な障害後に副作用が重複するリスクを減らします。

詳しいモデルについては、docs/security.md と docs/approval.md を参照してください。

クイックスタート

1. api.matemcp.com で MateMCP アカウントを作成するか、サインインします。
2. 以下のいずれかのコマンドを使って、お使いのコンピューターに MateMCP Desktop をインストールします。
3. Companion を開き、求められた場合は デバイス登録を完了します。
4. Agent 固有の MCP URL（例：https://relay.matemcp.com/mcp/agt_...）をコピーします。
5. その URL を ChatGPT、Claude、Grok、またはその他の MCP 対応 AI クライアントに追加します。
6. Agent を所有するものと同じ MateMCP アカウントで OAuth を完了します。
7. AI に設定済みのプロジェクトを一覧表示させたり、ファイルを調べさせたりするなど、安全性の高い最初のタスクを試します。
8. 機密性の高い操作で同意が必要な場合は、Companion またはアカウントポータルで承認内容を確認します。

Agent の更新で MCP ツールが追加または変更された場合： 一部のクライアントでは、以前のツール一覧が保持されることがあります。ChatGPT については、Agent の更新後に ChatGPT の MCP ツールを更新するを参照してください。

MateMCP Desktop のインストール／アップグレード

macOS

Apple Silicon 搭載 Mac の場合：

curl -fsSL https://raw.githubusercontent.com/vrassouli/MateMCP/main/scripts/bootstrap-macos.sh | bash

ブートストラップは Agent と Companion をそのままインストールまたはアップグレードし、Agent を起動します。必要に応じて対話型セットアップのために Companion を開き、既存の設定とセキュアな認証情報を保持します。

手動でのパッケージ：Apple Silicon 搭載 Mac 向け MateMCP Desktop · 最新の安定版リリース

Agent はユーザーごとの LaunchAgent として実行されます。Companion は ~/Applications/MateMCP Agent Companion.app にインストールされます。プライベート設定は ~/Library/Application Support/MateMCP に保存され、認証情報とシークレットには macOS Keychain が使用されます。

Computer Use には、該当する macOS のアクセシビリティおよび画面収録のアクセス許可が必要です。本番環境での署名と TCC ID の強化は引き続き改善中のため、開発用ビルドやアドホックビルドでは、更新後にアクセス許可を再度付与する必要が生じる場合があります。

Windows

PowerShell から実行します：

irm https://raw.githubusercontent.com/vrassouli/MateMCP/main/scripts/bootstrap-windows.ps1 | iex

Windows x64 では、ブートストラップによって Agent + Companion がインストールまたはアップグレードされ、バックグラウンドで Agent が起動します。対話型のセットアップが必要な場合は Companion が開き、ユーザー単位の設定と認証情報は保持されます。

手動パッケージ：MateMCP Desktop for Windows x64 · 最新の安定版リリース

プライベート設定は %APPDATA%\MateMCP に保存されます。登録済みの認証情報とシークレットは Windows 資格情報マネージャーに保存されます。

プラットフォームの状況

プラットフォーム	Agent	ネイティブ Companion	Computer Use ／ビジュアルサポート	備考
macOS Apple Silicon	✅	✅	✅	ネイティブのデスクトップ向けセマンティックアクションとビジュアルワークフローに対応します。macOS のアクセス許可が必要です。
macOS Intel	✅	Agent のみのパッケージ	一部対応	Intel Mac 向けの Companion は現在公開されていません。
Windows x64	✅	✅	✅	ネイティブの Windows Graphics Capture プレビューと、スクリーンショットへのフォールバックに対応します。
Windows ARM64	✅	Agent のみのパッケージ	一部対応	ネイティブの WGC ヘルパーは ARM64 向けにまだ提供されていません。スクリーンショットへのフォールバックは引き続き利用できます。

リモート MCP クライアントの状況

クライアント	現在の検証状況
ChatGPT	エンドツーエンドのフィールドテストを実施した主要なリモート MCP クライアントです。
Claude	公開 MateMCP Relay 経由で接続できることを確認しています。クライアント固有の機能の挙動は異なる場合があります。
Grok	公開 MateMCP Relay 経由で接続できることを確認しています。クライアント固有の機能の挙動は異なる場合があります。
その他の MCP クライアント	MateMCP は標準ベースの MCP/OAuth インターフェースを使用しています。互換性はクライアント／プロバイダーごとに検証する必要があります。

公開 Relay への到達性は、クライアントプロバイダーが使用するネットワーク経路によって異なる場合があります。本番環境の MateMCP デプロイでは、Agent 向けの MCP URL モデルを変更せずに、公開ホスト名の前段に Cloudflare または別の HTTPS エッジ／リバースプロキシを配置できます。

Companion の概要

Companion は、ユーザーがローカルで操作するためのインターフェースです。現在、次の機能を利用できます。

• Agent の 起動／停止／再起動 とステータス表示。
• MCP エンドポイントの表示とコピー操作。
• 保留中の 承認 とポリシーの管理。
• インタラクティブシェル セッション。
• OS の認証情報ストアを利用する シークレットマネージャー。
• アクティビティと監査 の履歴。
• Agent ログ と診断情報。
• グローバルスキルとメモリ の確認と管理。プロジェクトスキルは、各リポジトリ内の通常のバージョン管理対象ファイルです。
• Computer Use のプレビュー／ステータス。
• 使用中のスリープを防止 する制御。Agent の最新のアクティビティ後、15 分間のアイドル猶予期間が設けられます。
• 手動での更新確認と、対応プラットフォームでの任意の Desktop 自動更新。

アカウントポータルの概要

ブラウザーから利用するアカウントポータル api.matemcp.com は、ローカルの Companion を補完します。現在、ポータルでは次の機能を利用できます。

• 通常のアカウント／セッション管理機能を備えたログインと登録。
• 登録済みデバイスのデバイス管理。コントロールプレーンでサポートされているステータス表示と、取り消し／削除の操作を含みます。
• バックエンドでサポートされている保留中のアクションと最近の履歴表示を備えた承認。
• 権限を持つ管理者向けの管理機能。ユーザーの検索／ステータス管理や、適切なデバイス管理を含みます。
• ユーザー／管理者の操作に対するサーバー側の認可。Agent の機密性の高い認証情報や保存済みのシークレットがポータルを通じて公開されることはありません。

セルフホスト型 Web ＋アカウントポータル/API ＋ Relay

通常の単一サーバーへのデプロイでは、標準のインストール／更新コマンドを 1 つ使用します。

curl -fsSL https://raw.githubusercontent.com/vrassouli/MateMCP/main/deploy/install.sh | sudo bash

インストーラーは既存の設定を保持するため、更新時も安全です。不足している設定値のみを尋ね、現在の Compose 定義を更新し、公開 Web、API、Relay サービスをプルして再作成します。また、プライベート API↔Relay 認証情報を同期し、成功を報告する前にサービスのヘルスチェックを行います。サポート対象の Debian/Ubuntu ホストでは、必要に応じて Docker Engine ＋ Compose をセットアップできます。

Web、API、Relay を個別に管理する高度なデプロイでのみ、コンポーネント別のインストーラーを使用してください。

# Public product website
curl -fsSL https://raw.githubusercontent.com/vrassouli/MateMCP/main/deploy/web/install.sh | sudo bash

# API / Control Plane
curl -fsSL https://raw.githubusercontent.com/vrassouli/MateMCP/main/deploy/api/install.sh | sudo bash

# Relay
curl -fsSL https://raw.githubusercontent.com/vrassouli/MateMCP/main/deploy/relay/install.sh | sudo bash

API は、小規模な単一サーバーへのデプロイでは SQLite を、外部データベースを使用するデプロイでは SQL Server をサポートしています。Web、API、Relay は HTTPS リバースプロキシの背後に配置し、コンテナーのポートをインターネットに直接公開しないでください。matemcp.com、api.matemcp.com、relay.matemcp.com は、それぞれ独立したバックエンドにルーティングしてください。

外部 ID プロバイダーは任意であり、デプロイ環境によって異なります。プロバイダーの設定、コールバック URL、アカウント連携の動作については、docs/external-login-providers.md を参照してください。デプロイ環境向けに設定および検証済みのプロバイダーのみを有効にしてください。

Cloudflare の使用は任意です。MateMCP の前段で使用する場合は、3 つの公開ホスト名をそれぞれ独立してルーティングし、元の HTTPS ホスト／スキームを維持してください。また、認証済み API レスポンスをキャッシュしないでください。同じデプロイパターンは、他の HTTPS リバースプロキシ／エッジでも使用できます。

本番環境のホスト名／TLS ルーティングについては、docs/production-web-deployment.md を参照してください。Web のデプロイに関する詳細は deploy/web/README.md に、Relay 固有のリバースプロキシに関するガイダンスは引き続き deploy/relay/README.md に記載されています。

ドキュメント

トピック	ドキュメント
アーキテクチャ	docs/architecture.md
セキュリティモデル	docs/security.md
承認	docs/approval.md
エージェント／プラットフォームの機能の同等性	docs/agent-feature-parity.md
コンピューター操作	docs/computer-use.md
デスクトップ制御	docs/desktop-control.md
macOS のセマンティックアクション	docs/macos-semantic-actions.md
ブラウザーのビジュアル QA	docs/browser-visual-qa.md
添付ファイルの転送	docs/attachment-transfer.md
対話型シェルのシークレット	docs/interactive-shell-secrets.md
認証情報の注入	docs/credential-injection.md
接続性／カオスのテスト範囲	docs/connectivity-chaos-testing.md
ChatGPT ツールの更新	docs/chatgpt-tool-refresh.md
プロジェクトコンテキストとリポジトリの Skills	docs/project-context-bootstrap.md
本番 Web デプロイ	docs/production-web-deployment.md
外部ログインプロバイダー	docs/external-login-providers.md
開発ワークフロー	docs/development-workflow.md
ロードマップ	docs/roadmap.md

現在の制限事項と進行中の作業

MateMCP は現在開発中です。一部の領域は、意図的に慎重な対応を続けているか、強化を進めています。

• Native Companion のパッケージングは、現在 Windows x64 と macOS Apple Silicon を主な対象としています。
• Windows ARM64 では、ネイティブの WGC プレビュー ヘルパーではなく、スクリーンショットへのフォールバックを使用します。
• macOS の本番環境向け署名と TCC アイデンティティについては、すべての本番環境向けアップデート後も権限が確実に維持されるよう、引き続き強化が必要です。
• Global Skills & Memory とリポジトリの Skills は現在利用できますが、異なる AI クライアント間での積極的なコンテキスト自動利用は、引き続き改善中です。
• ChatGPT は引き続き、エンドツーエンドの互換性を完全に確保する主な対象です。Claude と Grok への接続も検証済みですが、プロバイダー固有の機能の動作には違いが生じる場合があります。
• Safe & Informed Approvals は、承認ダイアログが生のコマンド構文だけに頼らず、影響とリスクを説明できるよう拡張中です。

リリース

main は安定版開発の信頼できる情報源です。更新される agent-latest リリースには、現在の安定版 Agent パッケージと、対応アーキテクチャ向けのネイティブ Desktop パッケージが含まれています。v0.1.0 のようなバージョンタグでは、バージョン付きのリリースアセットが公開されます。

GitHub Issues と Pull Requests を通じた貢献やフィールドテストの報告を歓迎します。