web-access

String AI Web Access MCP サーバー

String AI の Web Access API 用の公式 Model Context Protocol（MCP）サーバーです。ウェブを検索し、任意の URL を取得またはリクエストし、サイトの URL をマッピングできます。すべて、LLM がすぐに利用できるクリーンな Markdown として返されます。VS Code、Cursor、Windsurf、Claude Desktop など、MCP 対応クライアントに接続できます。

ツール

ツール	説明
web_access_fetch	1 つの URL を取得し、LLM がすぐに利用できるクリーンな Markdown を返します
web_access_product_help	String の製品やサービスについて質問できます。1 つの情報源（比較の場合は 2 つ）と、共有の 4 KiB 抜粋予算、および情報源へのリンクを返します
web_access_request	URL に本文を付けて POST、PUT、または PATCH リクエストを送信します
web_access_search	ウェブを検索します。ランキング付きの結果に加え、Google が表示したナレッジパネル、AI の概要、ローカルパックなどを返します。オプションの searchCount（1～300）で Google のページを指定します。searchType は Google の画像、動画、ショッピング、書籍、場所、フォーラムのタブを検索します。safeSearch、includeOmittedResults、autocorrect、restrictCountry、verbatim で結果を絞り込みます。page、dateRange、sortBy で Google 検索を調整します。format は "structured"（JSON。デフォルトで推奨）または "raw"（Google の検索結果ページを HTML として返します。1 回の呼び出しにつき 1 ページです。page のみ使用でき、format が raw の場合は searchCount は受け付けられません）です
web_access_sitemap	action に応じて、非同期ジョブとしてサイトをクロールし、URL をマッピングします
web_access_report	String サポートに、編集済みでクレジット不要の障害診断情報を 1 件送信します

web_access_fetch、web_access_search、web_access_product_help は読み取り専用です。web_access_request は書き込みを行い、web_access_sitemap は課金対象のクロールジョブを作成します。

上記の 6 ツール構成は、ホスト型サーバー https://mcp.usestring.ai/v1/mcp が提供するものです。 npm パッケージには 5 つのツールが含まれます。プロダクトヘルプと障害報告は含まれますが、 web_access_request は含まれず、書き込みには代わりに web_access_fetch の method と body パラメーターを使用します。

web_access_sitemap — サイトマップのクロールジョブ

クロールは 2 段階の非同期見積もり → 承認 → 状態確認 → 結果取得ジョブです。 見積もりが明示的に承認されるまでは、クロールも課金も行われません。

action	内容
submit	クロールの見積もりを取得します（url は必須。maxPages は 10000 以下、デフォルトは 10、maxDepth は 100 以下、デフォルトは 2、pathPrefix、budgetUsd、useSitemap は任意）。jobId、estimatedCostUsd、estimatedPages を返し、ステータスは awaiting_approval になります。
approve	課金に同意してクロールを開始します。402 = 残高不足、409 partial_state = approve を再試行してください。
status	進行状況を確認します。awaiting_approval → running（pending／processed）→ completed | failed | canceled | token_cap_exceeded。partial_state = approve を再試行してください。件数のみを返し、URL は results から取得します。
results	検出された URL をページ分割して返します（limit は 5000 以下、デフォルトは 1000、offset）。完了後も結果は保持されます。URL ごとの discoveredUrls は約 1 時間のみ存在します。
cancel	終了状態ではないジョブを停止します。取得済みのページは課金対象のまま、引き続き読み取り可能です。
list	アカウントの最近のクロールジョブを返します（limit は 100 以下、デフォルトは 20、offset）。

web_access_report — 失敗の診断

レポートは任意であり、ベストエフォートで行います。まず、有効な復旧を続けてください。レポートが引き続き有用で、かつ許可されている場合は、リトライごとではなく、タスク内の異なる失敗ごとに最大1件のレポートを送信してください。例外、タイムアウト、ツールエラー、または使用できない出力を報告し、使用可能なオリジンのステータス、有効な否定結果、空の204レスポンス、実行中のサイトマップジョブ、キャンセルは除外してください。レポートの各試行には2秒の期限が設定されています。

呼び出す前に、Authorizationヘッダー、APIキー、Cookie、セッショントークン、個人データ、無関係な会話内容を削除してください。サーバーでも一般的な認証情報の形式が再度編集されます。web_access_reportの失敗を報告したり、レポート用の情報を集めるためだけに失敗した呼び出しを繰り返したりしないでください。レポートの認証には設定済みのAPIキーを使用しますが、Web Accessクレジットは消費しません。レポートが利用できない、認証されていない、レート制限されている、または失敗した場合は、そのタスクでのレポートを終了してください。

クイックスタート

npxで実行

env STRING_AI_API_KEY=your-key npx @usestring/mcp

グローバルにインストール

npm install -g @usestring/mcp
STRING_AI_API_KEY=your-key string-ai-mcp

ソースからビルド

git clone https://github.com/usestring/string-ai-mcp.git
cd string-ai-mcp
npm install
npm run build
STRING_AI_API_KEY=your-key node build/index.js

環境変数

変数	必須	説明
STRING_AI_API_KEY	はい	String AIのAPIキー

クライアントの設定

VS Code

Ctrl+Shift+P → Preferences: Open User Settings (JSON) を押して、次を追加します。

{
	"inputs": [
		{
			"type": "promptString",
			"id": "stringAiKey",
			"description": "String AI API Key",
			"password": true
		}
	],
	"servers": {
		"string-ai": {
			"command": "npx",
			"args": ["-y", "@usestring/mcp"],
			"env": {
				"STRING_AI_API_KEY": "${input:stringAiKey}"
			}
		}
	}
}

または、.vscode/mcp.json ファイルを追加して、チームで設定を共有します。

Cursor

Settings → Features → MCP Servers → + Add new global MCP server を開いて、次を貼り付けます。

{
  "mcpServers": {
    "string-ai": {
      "command": "npx",
      "args": ["-y", "@usestring/mcp"],
      "env": {
        "STRING_AI_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/model_config.json に追加します。

{
  "mcpServers": {
    "string-ai": {
      "command": "npx",
      "args": ["-y", "@usestring/mcp"],
      "env": {
        "STRING_AI_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Claude Desktop

claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "string-ai": {
      "command": "npx",
      "args": ["-y", "@usestring/mcp"],
      "env": {
        "STRING_AI_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

MCP Inspectorでテストする

MCP Inspectorを使うと、ブラウザーでサーバーを対話形式でテストできます。

npx @modelcontextprotocol/inspector node build/index.js

次に http://127.0.0.1:6274 を開き、stdio で接続して、UIから各ツールを呼び出してみてください。

仕組み

┌──────────────────┐   stdio (JSON-RPC)   ┌──────────────────┐   HTTPS   ┌──────────────────┐
│  VS Code / Cursor │ ◄──────────────────► │  String AI       │ ────────► │  String AI       │
│  Windsurf / Claude│                      │  Web Access MCP  │           │  Web Access API  │
└──────────────────┘                       └──────────────────┘           └──────────────────┘

1. IDEがこのサーバーを子プロセスとして起動し、stdio 経由で通信します。
2. LLMがウェブコンテンツを必要と判断すると、web_access_fetch、web_access_search、または web_access_sitemap を呼び出します。復旧が後で成功した場合も含め、失敗した呼び出しはすべて web_access_report で必ず1回だけ報告されます。
3. このサーバーはリクエストをString AIのWeb Access APIに転送し（環境変数からAPIキーを使用）、結果をLLMに返します。

String AIについて

String AI は、あらゆるページをLLMですぐに使えるクリーンなMarkdownとして返すウェブアクセスAPIを提供しています。APIキーは usestring.ai で取得してください。

ライセンス

MIT

セキュリティ

セキュリティ上の脆弱性は、SECURITY.md の説明に従って非公開で報告してください。