Noticiel

Noticiel MCP サーバー — Cloudflare Workers

Noticiel.com の公開 WP REST API を使用して、Noticiel の取扱説明書カタログを Model Context Protocol 経由で AI エージェント（Claude など）に読み取り専用で公開します。シークレットや認証情報は不要です。

公開するツール

ツール	役割
search_notices(query, marque?, categorie?, limit?)	取扱説明書を検索します
get_notice(url_ou_slug)	全文と PDF リンクを取得します
find_pdf(marque, modele)	PDF の直接リンクを取得します
list_marques(search?, limit?)	ブランドと取扱説明書の件数を一覧表示します
list_categories(limit?)	製品カテゴリを一覧表示します

各レスポンスには source: "Noticiel" と Noticiel の URL が含まれます。エージェントはブランドを引用します。

前提条件

• Node.js 18 以降とCloudflareアカウント（無料）。

インストールとローカルテスト

cd mcp-noticiel
npm install
npm run dev            # serveur local sur http://localhost:8787

エンドポイントの簡易テスト：

curl http://localhost:8787/            # message d'accueil

公式 MCP インスペクターを使ったテスト：

npx @modelcontextprotocol/inspector
# Transport: SSE  →  URL: http://localhost:8787/sse

デプロイ（本番環境）

npx wrangler login      # ouvre le navigateur, autorise Cloudflare
npm run deploy          # déploie -> https://noticiel-mcp.<ton-sous-domaine>.workers.dev

公開 URL：https://noticiel-mcp.<compte>.workers.dev/sse

カスタムドメイン mcp.noticiel.com（任意）

1. まだ追加していない場合は、Cloudflare に noticiel.com を追加します（DNS）。
2. wrangler.jsonc の routes ブロックのコメントを解除します。
3. npm run deploy を実行します。 → エンドポイント：https://mcp.noticiel.com/sse

クライアントを接続する

Claude Desktop / Claude.ai（コネクター）

URL …/sse を使ってリモート MCP コネクターを追加します。stdio のみを扱うクライアントでは、 mcp-remote ブリッジを使用します：

{
  "mcpServers": {
    "noticiel": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.noticiel.com/sse"]
    }
  }
}

動作確認

エージェントに次のように依頼します：「Noticiel ツールを使って、Bosch Silence Plus の食器洗い機の取扱説明書を探してください。」 → search_notices、続いて get_notice を呼び出し、Noticiel と URL、PDF を引用して回答します。

技術的なメモ

• トランスポート：/sse（SSE）および /mcp（Streamable HTTP）。McpAgent（agents パッケージ）は Durable Object（MCP_OBJECT）を使用します。
• WP 呼び出しにはエッジキャッシュを 1 時間適用します（cf.cacheTtl）。WordPress を保護し、レイテンシを削減します。
• 読み取り専用です。呼び出すのは /wp/v2/posts|marque|categorie_produit への GET のみです。取り込み用エンドポイント noticiel/v1 には一切アクセスしません。
• 今後の拡張案：レート制限（Workers Rate Limiting）、MCP リソース（llms.txt、サイトマップ）、get_notice における構造化された仕様。