Docs開発者ガイド

開発者ガイド

自社サービスに FindIP を組み込む、またはカスタム LLM 環境に MCP サーバーを自己ホストする開発者向けのガイドです。一般ユーザーとして Claude・ChatGPT・Gemini などに接続される場合は AI 接続ガイドを先にご確認ください。

自社サービスに REST API を組み込む

MCP に非対応の環境(Web アプリ、モバイル、社内システム)に検索機能を直接組み込む際に利用します。HTTP ヘッダに API キーを入れるだけで使えます。

1. API キー発行

ダッシュボードで無料発行できます。

2. エンドポイント仕様

セマンティック検索・統計・認証エンドポイントの仕様。

cURL

# セマンティック検索の呼び出し例
curl -X POST https://api.findip.ai/api/v1/search/semantic \
-H "X-API-Key: psk_live_..." \
-H "Content-Type: application/json" \
-d '{
  "query": "リチウムデンドライト成長を抑える固体電解質技術",
  "top_k": 5
}'

カスタム MCP ホスティング

FindIP MCP サーバーは Node.js ベースで、2 つのホスティング方式に対応します。

NPM パッケージ (stdio): ローカルデスクトップアプリの設定ファイルに CLI コマンドを直接注入。API キーは環境変数として必要。
SSE / Streamable HTTP エンドポイント: Web サービスや分散環境で複数エージェントが単一の MCP サーバーを共有する際に使用。認証は OAuth または API キー。

NPM パッケージ (stdio)

# グローバルインストール
npm install -g @findip/patent-search-mcp

# 直接実行
FINDIP_API_KEY=psk_live_... npx @findip/patent-search-mcp

Claude Desktop カスタム設定

{
"mcpServers": {
  "findip-mcp": {
    "command": "npx",
    "args": ["-y", "@findip/patent-search-mcp"],
    "env": {
      "FINDIP_API_KEY": "psk_live_..."
    }
  }
}
}

ご注意

現在 @findip/patent-search-mcp NPM パッケージは非公開ベータです。正式リリースまではリモート SSE URL(https://api.findip.ai/mcp)のご利用を推奨します。