SAM.gov 米国調達公告・法人登録 を Codex につなぐ
Codex から SAM.gov 米国調達公告・法人登録 を直接問い合わせられます。Arlet が 1 つの MCP 接続で仲介し、API キーの管理を引き受けます。
GSA が運営する、米国政府の調達公告・法人登録の公式システム SAM.gov にAIクライアントから接続できるサーバーです。
主な機能:
- search_opportunities: 入札公告・事前公告・統合公告・市場調査 (Sources Sought)・落札通知を、タイトルキーワード・NAICS コード・公告種別・機関・履行地の州・掲載日の範囲で検索します。掲載日の範囲は既定で直近 90 日、上流仕様により最大 1 年です。日付は ISO 形式で受け取り、SAM.gov の MM/dd/yyyy へ自動変換します。
- search_entities: 米国政府と取引するために登録された法人・団体を、正式名称・12桁の UEI・5桁の CAGE コードで照会します。登録状態と有効期限・所在地・各種識別子を返します。
search_entities が返す UEI は USAspending が受注者に使う識別子と同一なので、2 つのサーバーはきれいに突き合わせられます (こちらで法人を見つけ、あちらで受注実績を引く)。USASpending との分担は「SAM.gov は公告が出る場所 (落札前〜落札時)、USAspending は実際の支出が記録される場所」です。
利用には SAM.gov アカウントの Account Details ページで発行する個人 API キーが必要です (ログイン必須で、キーはアカウントのロールに紐づきます)。Arlet の環境変数 SAM_GOV_API_KEY に設定してください。上流ゲートウェイは無効なキーに空の 404 を返しますが、本サーバーが行動可能なエラーメッセージに変換します。
SAM.gov 米国調達公告・法人登録 を Codex につなぐ手順
- 1
Arlet のダッシュボードの「データ取得ツール」で SAM.gov 米国調達公告・法人登録 を探し、SAM.gov 米国調達公告・法人登録 側で発行した API キーを設定してスイッチを ON にします。
- 2
ターミナルで codex mcp add arlet --url https://mcp.arlet.dev/mcp/ を実行し、Arlet を MCP サーバーとして追加します。
- 3
Codex が OAuth 対応を検出して自動でブラウザを開くので、Google でサインインし、同意画面で Allow を押します。
- 4
接続が完了すると、CLI と IDE 拡張の両方から Arlet のツールを呼び出せます (設定は共有されます)。
ブラウザが開かない場合は codex mcp login arlet を実行して認証をやり直せます。