artifacta

Artifacta MCP サーバー

Artifacta の公式 MCP サーバーです。Artifacta は AI エージェント向けに特化したアーティファクトストアです。エージェントは、実行結果（ファイル、レポート、データセット、ビルド結果）をセッションとエージェントのメタデータとともに保存し、セッション間で引き継いだり、有効期限付きのダウンロードリンクで共有したりできます。コンテンツハッシュによる重複排除により、同じバイト列を再保存しても費用はかかりません。

公式 MCP レジストリには io.artifacta/mcp として登録されています。

ツールの構成、エラー契約、パス制限エンジンが共通の、2 つの実装を提供しています。

ディレクトリ	パッケージ	ランタイム
typescript/	@artifacta-mcp/mcp	Node 20+
python/	artifacta-mcp	Python 3.10+

Claude Code プラグインとしてインストールする

Claude Code では、このリポジトリを兼ねたプラグインマーケットプレイスを使うのが最も手早い方法です。ホスト型サーバーと、実行結果を自動で保存するスキルの両方が設定されます。

/plugin marketplace add SagaPeak/artifacta-mcp
/plugin install artifacta@artifacta

これには、以下のクイックスタートと同じホスト型 MCP 接続に加え、persisting-outputs スキル（/artifacta:persisting-outputs。保存に値する実行結果がセッションにある場合は自動的に起動します）が含まれます。/plugin marketplace update artifacta を実行してプラグインを更新してください。プラグインのセットアップガイドをご覧ください。

クイックスタート

接続する最も手早い方法はホスト型サーバーを使うことです。インストールも API キーも不要です。

claude mcp add --transport http artifacta https://mcp.artifacta.io/mcp

初回使用時に、クライアントは OAuth Dynamic Client Registration（PKCE）で自動登録し、認可のためにブラウザーを開きます。コピーや保存が必要な ak_live_ キーはありません。ホスト型セットアップガイドをご覧ください。

ローカル／CI（stdio）

ブラウザーでの OAuth フローを利用できないヘッドレス、エアギャップ、または CI 環境では、API キーを使ってパッケージをローカルで stdio 経由で実行します。app.artifacta.io/dashboard/keys でキーを取得し、MCP クライアント（Claude Desktop、Claude Code、Cursor、または任意の MCP クライアント）の設定に追加してください。

{
  "mcpServers": {
    "artifacta": {
      "command": "npx",
      "args": ["-y", "@artifacta-mcp/mcp"],
      "env": {
        "ARTIFACTA_API_KEY": "ak_live_..."
      }
    }
  }
}

または、pipx run artifacta-mcp で Python 実装を実行してください。

設定ファイルのプロファイル、パス制限（--allow-path）、破壊的ツールの制御（--allow-destructive）、トラブルシューティングについては、各パッケージの README をご覧ください：TypeScript · Python。

ツール

ツール	説明
whoami	認証情報を確認します。テナントとプランの情報を返します
store_artifact	インラインコンテンツまたはローカルパスからアーティファクトをアップロードします
request_upload_url / complete_upload	大容量ファイル向けの2段階の署名付きアップロードです
get_artifact	IDでアーティファクトのメタデータを取得します
get_artifact_download_url	署名付きダウンロード URL を取得します（有効期限は1時間です）
list_artifacts	セッション、エージェント、またはメタデータでアーティファクトを一覧表示／絞り込みます
list_sessions	アクティブなセッションを一覧表示します
seal_session	セッションを封印し、以後アーティファクトを追加できないようにします（--allow-destructive が必要です）
create_download_link	有効期限付きの公開共有リンクを作成します（--allow-destructive が必要です）
delete_artifact	アーティファクトを論理削除します（--allow-destructive が必要です。create_download_link と同じ制限が適用されます）
publish_artifact	アーティファクトを artifacta.io/a/{slug} の公開ページとして公開します（Artifact Pages）。冪等で、デフォルトでは非公開リストです
unpublish_artifact	アーティファクトの公開ページを取り下げます。アーティファクト自体には影響しません。冪等です

さらに、whoami、アーティファクトのメタデータ、アーティファクトのバイトデータ、セッション向けの MCP リソースがあります。

安全性のデフォルト設定として、ローカルファイルのアップロードは明示的に指定した --allow-path の許可リスト内に制限されます。また、破壊的なツール（公開共有リンク、削除、セッションの封印）は、書き込みを確認できないクライアントに対して非表示になります。ただし、--allow-destructive を渡すと利用できます。publish_artifact と unpublish_artifact は冪等な書き込み操作であり、破壊的な操作ではないため、--allow-destructive は必要ありません。

ホスト型 OAuth 接続（mcp.artifacta.io）では、さらに別の制御レイヤーが追加されます。認証画面では、artifacts:read ⊆ artifacts:write ⊆ artifacts:destroy の3つのスコープのいずれかが許可されます。13個すべてのツールは常に tools/list に表示されます。トークンで許可されていないツールを呼び出すと、不足しているスコープを示す insufficient_scope コードのツールエラーが返されます。より広いスコープで再認証すると解決できます。スコープによる制限はホスト型 OAuth にのみ適用されます。ak_live_ API キーとローカル stdio は引き続きフルアクセスで、代わりに --allow-destructive／確認フラグを使用します。

フレームワーク統合

Python パッケージには、OpenAI Agents SDK（pip install 'artifacta-mcp[openai-agents]'）および LangChain/LangGraph（`pip install 'artifacta-mcp[langchain]'）向けのオプションアダプターが含まれています。

ドキュメント

詳しいドキュメントは docs.artifacta.io/mcp/overview をご覧ください。

開発

# TypeScript
cd typescript && npm install && npm test

# Python
cd python && python -m venv .venv && source .venv/bin/activate
pip install -e '.[dev]' && pytest

このリポジトリは Artifacta モノレポから公開されています。こちらでのイシューや PR を歓迎します。

ライセンス

MIT — LICENSE をご覧ください。