518.PLUS

概要

見つける	マーケットプレイスを閲覧するか、MCP を使ってツール、その入力、価格を一覧表示・検索できます。
実行する	MCP、ウェブ、または /v1 を通じてツールを使用できます。結果は各ツールの宣言に応じて、テキスト、JSON、またはファイルになります。
共有する	結果ページまたはファイルへのリンクを送信できます。ファイルへのリンクには有効期限とダウンロード上限があります。
公開する	ツールの契約に準拠した HTTPS エンドポイントを登録します。新しいツールは最初は非公開です。公開する前に、自分のツールを 1 回正常に実行してください。有料の呼び出しから、プロバイダーへの分配分を得られます。

エージェントを接続する

接続方法は 2 つあります。どちらかを選んでください。

OAuth でサインインする：OAuth に対応した MCP クライアントにサーバー URL を追加します。プロンプトが表示されたら、518 アカウントにサインインするか、新規作成して、要求された権限を承認します。OAuth トークンはクライアントが管理します。

claude mcp add --transport http 518-plus https://518.plus/mcp

API キーを使う：既存のアカウントにサインインし、518.plus/account/keys でキーを作成または表示します。新しいアカウントが必要なエージェントは、HTTPS 経由で登録できます。

curl -s -X POST https://518.plus/auth/mcp/register -H "Content-Type: application/json" -d '{}'
# → {"ok":true,"username":"agent_…","password":"…","key":{"key":"fsk_…",…}}
# save the username and password; use key.key as the Bearer credential

その後、すべてのリクエストに Authorization: Bearer fsk_YOUR_API_KEY を付けます。

{
  "mcpServers": {
    "518-plus": {
      "type": "http",
      "url": "https://518.plus/mcp",
      "headers": { "Authorization": "Bearer fsk_YOUR_API_KEY" }
    }
  }
}

同じキーを REST インターフェースでも使用できます。

curl -s -X POST https://518.plus/v1/tools/compress \
  -H "Authorization: Bearer fsk_YOUR_API_KEY" \
  -H "Idempotency-Key: compress-request-1" \
  -F "[email protected]"

GET /v1/tools でカタログを一覧表示できます。Idempotency-Key を指定すると、安全に再試行できます。 本文入力ツールは、リクエスト本文そのものを入力として受け取ります（Content-Type は 宣言に従ってください）。

プラグインやコネクターをパッケージ化する場合は、CIMD（HTTPS クライアントメタデータドキュメント）または DCR（POST /oauth/register）で OAuth クライアントを識別します。ディスカバリーは 518.plus/.well-known/oauth-authorization-server から開始できます。クライアント登録によってアプリケーションは記録されますが、518 アカウントが作成されたり、そのアカウントへのアクセス権が付与されたりするわけではありません。アカウント所有者は、要求されたスコープ tools:call、files:read、files:delete を別途承認します。

MCP のファイル入力には、インラインの base64、HTTPS URL、または参照を使用できます。大きなファイルは 2 段階でアップロードします。実行とアップロードチケットには、安定した client_ref が必要です。同じ操作を再試行する場合は、同じ値を再利用してください。ディスカバリーとファイル管理のツールでは、宣言された引数を使用します。エージェント向けガイドの全文は 518.plus/llms.txt をご覧ください。

ホームページにもリンクされている エージェントプラグインのダウンロードには、plugin.json と mcp.json を含むポータブルな 518-plus プラグインディレクトリが収録されています。展開して、お使いのクライアントの エージェントプラグインのインストール手順に従ってください。同じ /mcp エンドポイントに接続します。上記の OAuth または API キーによるアクセス方法を使用してください。このパッケージにアカウント認証情報は含まれていません。

ツールを公開する

公開されたツールは、ツールコントラクトに準拠する HTTPS エンドポイントです。ファイル入力を受け取るツールの場合、518 はファイルのメタデータ、取得 URL、パラメーターを送信します。

{
  "files": [{ "filename": "a.png", "content_type": "image/png", "size": 1024, "url": "https://..." }],
  "params": { "quality": 80 }
}

テキスト、JSON、ファイルの結果を順序付きリストで返すには、Content-Type: application/vnd.518.items+json を指定します。

{
  "items": [
    { "kind": "text", "text": "Compressed 1 image" },
    { "kind": "file", "filename": "a.png", "content_type": "image/png", "data_b64": "..." }
  ]
}

クレジットで価格を設定します（1,000 クレジット＝1 米ドル）。呼び出しに失敗した場合、ユーザーには自動的に返金されます。有料の呼び出しごとの取り分は収益残高に加算され、出金できます。宣言と実行の完全なコントラクトはdocs/publishing.mdに記載されています。

新しいツールは、最初は非公開で公開されます（公開マーケットには掲載されません）。自分のツールを一度正常に実行すると、「マイツール」から公開できます。プラットフォームによるツールの審査はありません。公開の取り消しに制限はありません。

セルフホスト

必要なもの：Python 3.12、PostgreSQL 16、Gokapi v2.2.4、Nginx。

git clone https://github.com/samelabs/FlashShare.git && cd FlashShare
python3.12 -m venv venv && venv/bin/pip install -r requirements.txt
# set the environment variables listed in DEVELOPMENT.md, then:
venv/bin/python -m uvicorn app.main:app --host 127.0.0.1 --port 8000 --workers 1

データベーススキーマは初回起動時に作成されます。設定、デプロイ、テストについてはDEVELOPMENT.mdを参照してください。

貢献

アーキテクチャコントラクトについてはAGENTS.mdを、ローカルのテストスタックについてはDEVELOPMENT.mdをお読みください。プルリクエストは CI を通過する必要があります。

セキュリティ

脆弱性は非公開で報告してください。詳細はSECURITY.mdを参照してください。

ライセンス

AGPL-3.0