sedis-ab

@sedis/mcp

Sedis PartnerAPI v2 を厳選した少数の読み取り専用ツールとして利用できるようにする、Model Context Protocol（MCP）サーバーです。AI アシスタントやエージェント（Claude Desktop、Cursor、および MCP 対応クライアント）が、Sedis の Bolagsanalys（上場企業の財務データ）や Fastighetsbenchmark（不動産の比較データ）を自然言語で問い合わせられます。このサーバーは薄い中継層であり、データの形式と転送のみを担います。テナント分離、認証、レート制限、課金に関するルールはすべて PartnerAPI v2 側で管理されます。

Sedis のお客様ではありませんか？ このサーバーの利用には Sedis PartnerAPI v2 のキーが必要です。無料プランやトライアルはありません。お問い合わせください： [email protected] · Sedis に問い合わせる

インストール

最も簡単な方法：Claude Desktop 用ワンクリックバンドル（.mcpb）— 推奨

技術に詳しくないユーザーには、デスクトップ拡張機能のインストールをおすすめします。単一ファイルで、Node も JSON もターミナルも必要ありません。

1. 最新リリースから sedis-mcp.mcpb をダウンロードします。
2. ダブルクリックするか、Claude Desktop → Settings → Extensions を開いてファイルをドラッグし、Install をクリックします。
3. 表示されたフィールドに Sedis API キーを貼り付け（OS のキーチェーンに保存されます）、確定します。
4. 完了です。チャットを開始して、たとえば 「Fabege の主要指標を表示して」 と尋ねます（スウェーデン語の場合は lang: "sv"）。

このバンドルには、以下で説明するサーバーとその依存関係がそのまま含まれています。Node ランタイムは Claude Desktop が提供するため、ユーザーがほかにインストールするものはありません。キーについては Sedis の管理者にお問い合わせください。顧客レベル（M2M）のキーなら、セッションごとの二要素認証は不要です。メンテナーは npm run build:mcpb でバンドルをビルドします（出力先：dist/sedis-mcp.mcpb）。

手動設定（Claude Code、Cursor など、任意の MCP クライアント）

このサーバーは stdio 経由で動作し、npx を使って必要に応じて起動します。グローバルインストールは不要です。標準の起動コマンドは次のとおりです。

npx -y @sedis/mcp

クライアントの MCP 設定に追加し、PartnerAPI キーを設定します。

{
  "mcpServers": {
    "sedis": {
      "command": "npx",
      "args": ["-y", "@sedis/mcp"],
      "env": {
        "SEDIS_API_KEY": "your-partnerapi-v2-key"
      }
    }
  }
}

• Claude Desktop： 上記のブロックを claude_desktop_config.json に追加します。
• Cursor／その他のクライアント： クライアントの mcp.json に追加します（同じ形式です）。

設定

環境変数	必須	デフォルト	用途
SEDIS_API_KEY	はい	—	お使いの PartnerAPI v2 キーです。X-Api-Key ヘッダーとしてのみ送信され、ログには記録されません。
SEDIS_API_BASE_URL	いいえ	https://api.sedis.se	v2 のベース URL を上書きします（アルファ／ベータ環境などで使用します）。
SEDIS_API_SESSION	いいえ	—	セッション トークンの起動時の初期値として任意で指定します（ユーザー所有のキーのみ）。X-Api-Session として送信され、ログには記録されません。通常は代わりに実行時に set_session ツールで設定します。再起動は不要です。

キーは遅延検証されます。キーがなくてもサーバーは起動し、キーが未指定または無効の場合、最初のツール呼び出し時に分かりやすく対処方法が明記されたエラーを返します。起動時の ping はありません。

ツールが表示されませんか？ MCP サーバーはクライアントの起動時に読み込まれます。設定を編集した後は、クライアントを完全に再起動／再読み込みしてください（同じウィンドウで新しいチャットを開始するだけでは不十分です）。CLI（claude mcp add）で登録した場合は、正しいスコープに追加されたことを確認してください。あるディレクトリで追加したサーバーは、グローバル／ユーザースコープを使用しない限り、別のプロジェクトでは表示されません。

セッション トークン（ユーザー所有のキー）

キーが特定のユーザーに所有されている（マシン／M2M 統合キーではなく、名前のある個人に発行されている）場合、PartnerAPI v2 では X-Api-Key とともに短期間有効なセッション トークンが必要です。このトークンは、二要素認証を通じて定期的に更新します。

1. session_expired／session_invalid の理由を伴う 401 が発生すると、ツールエラーに reproveUrl が含まれます。ブラウザーで開き、2FA を完了して、新しく発行された sedis_sess_… トークンをコピーします。
2. set_session ツールで貼り付けます。トークンはクライアントの再起動なしで、次の呼び出しから X-Api-Session として送信されます。サインアウトするには clear_session を使用します。
3. 必要に応じて、起動時に SEDIS_API_SESSION 環境変数でトークンを初期設定できます（CI や上級ユーザーに便利です）。実行時に set_session で設定した値が常に優先されます。

マシン／組織全体のキー（所有者なし）はヘッドレスです。X-Api-Key のみを使用し、セッション トークンは不要です。また、set_session を呼び出す必要もありません。

ローカル開発／非本番環境への接続テスト

未公開のローカルビルドを実行する場合、または非本番環境を指定する場合は、npx をビルド済みのエントリーポイントに置き換え、ベース URL を上書きします。

{
  "mcpServers": {
    "sedis-local": {
      "command": "node",
      "args": ["/absolute/path/to/sedis-mcp/build/index.js"],
      "env": {
        "SEDIS_API_KEY": "your-non-production-key",
        "SEDIS_API_BASE_URL": "https://<your-non-production-host>"
      }
    }
  }
}

ホスト名については Sedis チームにお問い合わせください。非本番環境は公開されていません。これは開発時のみの利便機能です。本番環境のユーザーは、上記の npx -y @sedis/mcp ブロックを、SEDIS_API_KEY のみを指定して使用してください。デフォルトでは https://api.sedis.se が使用されます。

ツール

すべてのツールは読み取り専用です。テナントのスコープは v2 で強制されます。「YOUR …」ツールが返すのは、お使いのキーでアクセスが許可されたデータのみです。別のテナントのオブジェクトを要求した場合は、存在が漏れる 403 ではなく、分かりやすい not found が返されます。

Bolagsanalys（上場企業の財務情報）

ツール	機能
bolagsanalys_list_companies	上場企業のカタログを、名前の一部から検索します。
bolagsanalys_find_parameter	名前の一部から、適切な財務パラメーターを特定します。
bolagsanalys_get_data	四半期の数値を取得します。companyId を 1 つ指定するか、省略すると、指定したパラメーター／四半期の全企業を取得します。
bolagsanalys_search_data	特定の企業セットの数値を一括取得します。companyIds[]（最大 50 件）を指定します。

Fastighetsbenchmark（不動産の比較対象）

ツール	機能
fastighetsbenchmark_find_parameter	名前から適切な不動産ベンチマークのパラメーターを特定します。
fastighetsbenchmark_search_property_units	正確な name、名前の一部、市区町村、ゾーン、または不動産タイプ名（propertyTypeName。例：「Office」／「Kontor」）で、ユーザーの不動産ユニット（Fastighet）を検索します。
fastighetsbenchmark_list_samlingar	ユーザーのコレクション（Samling）とそのメンバーを一覧表示します。
fastighetsbenchmark_list_jamforelseobjekt	ユーザーの比較ゾーン（Jämförelseobjekt）を一覧表示します。
fastighetsbenchmark_get_comp_timeseries	実際の CompDatum ベンチマーク時系列データ（値の説明を含む）を取得します。
fastighetsbenchmark_list_reference_zones	Sedis が所有する共有の市場参照ゾーン（すべてのキーで共通）を一覧表示します。
fastighetsbenchmark_list_municipalities	municipalityId フィルター用の市区町村 IDを、名前または公式コード（例：SCB の 0180）から検索します。
fastighetsbenchmark_list_property_types	EB0 ドメインの propertyType フィルター用の不動産タイプ IDを検索します。

名前と説明はデフォルトで英語です。パラメーター検索ツールおよび不動産ユニット検索ツールに lang: "sv" を渡すと、スウェーデン語で表示されます。

セッション（ユーザー所有のキー）

ツール	機能
set_session	新しく発行された sedis_sess_… トークン（再認証ページから取得）を貼り付けます。次の呼び出しで X-Api-Session として送信され、再起動は不要です。
clear_session	現在のセッショントークンを削除します（サインアウト）。

これらが必要なのはユーザー所有のキーのみです（上記の セッショントークン を参照）。 マシン／組織全体のキーでは使用しません。

エラーは PartnerAPI v2 の RFC 7807 問題レスポンスから、サポート用の traceId を含む簡潔でわかりやすいツールエラーに変換されます。API キーやスタックトレースが含まれることはありません。ツールがセッション／二要素認証の再確認エラーを報告した場合は、メッセージ内の reproveUrl を開いて 2FA を完了し、新しい sedis_sess_… トークンをコピーして、set_session ツールから貼り付けてください。その後、再試行します（クライアントの再起動は不要です）。上記の セッショントークン（ユーザー所有のキー） を参照してください。

API リファレンス

このサーバーはラッパーです。基盤となるエンドポイント、クエリの規約、マルチテナント分離モデル、ジオメトリ、エラー形式、レート制限、データの鮮度については、Sedis が API キーとともに提供するPartnerAPI v2 ガイドに記載されています。アクセスが必要な場合は Sedis にお問い合わせください。最新の OpenAPI 定義は <SEDIS_API_BASE_URL>/openapi/v2.json（デフォルトは https://api.sedis.se/openapi/v2.json）で提供されています。この README ではそのリファレンスを重複して掲載しません。

データの利用

AI／LLM のコンテキストにおける Sedis データの利用は、お客様と Sedis との契約および付随する MCP データ利用規約に従います。キーの取り扱いとサプライチェーンに関する方針については、SECURITY.md を参照してください。

ライセンス

MIT。