SPIRAL ver.2のデータベースを、AIと自然言語で操作できたら便利だと思いませんか？
本記事では、MCP（Model Context Protocol）を使ってSPIRAL ver.2のAPIをMCPサーバーとして実装し、Claude DesktopやClaude CodeなどのAIクライアントから自然言語でSPIRALのレコードを検索・作成・更新・削除できる仕組みを構築する方法を解説します。
「未対応のお問い合わせを一覧で出して」「ステータスを対応中に更新して」といった指示をチャットに打ち込むだけで、AIがSPIRAL APIを自律的に呼び出し、結果を返してくれます。
実装はTypeScript（Node.js）で行い、Claude Desktopに接続して動作確認するまでの手順を解説します。

注意点

claude_desktop_config.json

env

delete_record

bulk_delete_records

confirmed: true

bulk_create_records

bulk_update_records

multipart/form-data

MCPとは？

MCP（Model Context Protocol）は、Anthropicが2024年に発表したオープンプロトコルです。
AIモデルが外部サービスのデータやツールを安全に呼び出すための共通規格で、現在はOpenAI・Google・Microsoft・AWSも採用しており、AI業界の事実上の標準となっています。
MCPサーバーを一度実装すれば、Claude Desktop・Claude Code・Cursorなど複数のAIクライアントから同じインターフェースで利用できます。

実装の概要

全体の流れは以下のとおりです。

事前準備

以下を用意してください。

node -v

設定方法

配布用ZIPは以下からダウンロードしてください。
spiral-mcp.zip をダウンロード

① 作業フォルダの作成

任意の場所で、作業用フォルダを作成して移動します。

mkdir spiral-mcp
cd spiral-mcp
        

② ダウンロードしたZIPを展開

spiral-mcp.zip

Copy-Item ".\spiral-mcp.zip" ".\tmp\spiral-mcp.zip"
Expand-Archive ".\tmp\spiral-mcp.zip" ".\tmp" -Force
Copy-Item ".\tmp\spiral-mcp\*" ".\" -Recurse -Force
        

package.json

src/

tsconfig.json

③ 依存インストールとビルド

展開したプロジェクトディレクトリで、依存パッケージをインストールしてビルドします。

npm install
npm run build

        

④ Claude Desktop設定ファイルを開く

claude_desktop_config.json

mcpServers

notepad %APPDATA%\Claude\claude_desktop_config.json
code %APPDATA%\Claude\claude_desktop_config.json
        

%APPDATA%\Claude\claude_desktop_config.json

~/Library/Application Support/Claude/claude_desktop_config.json

SPIRAL_API_KEY

SPIRAL_APP_ID

args

⑤ Claude Desktop再起動と接続確認

設定を反映するためClaude Desktopを再起動し、MCPサーバーを確認します。

taskkill /IM "Claude.exe" /F
start "" "%LocalAppData%\AnthropicClaude\Claude.exe"
        

args

C:/path/to/spiral-mcp/dist/index.js

dist/index.js

C:/Users/名前/spiral-mcp/dist/index.js

実装したMCPツール一覧（全15種）

list_databases

get_database_fields

search_records

fields

_id

field:asc|desc

get_record

create_record

update_record

delete_record

bulk_create_records

bulk_update_records

bulk_delete_records

get_email_logs

get_click_logs

get_open_logs

run_action

POST .../actions/{actionId}/run

recordId

issue_one_time_login_url

エラーハンドリング（失敗時の動き）

isError: true

401 Unauthorized

confirmed: false

search_records

offset

run_action

404

実行結果

Claude Desktopを再起動すると、MCPサーバーが自動的に接続されます。
接続確認は Settings（設定）> 開発者 から行えます。インストール済みのMCPサーバーとその状態（有効/無効）が一覧表示されます。
また、チャット入力欄左下の 「+」ボタン > コネクタ から接続中のMCPサーバーが確認できます。

AIがツールを使用する際は、チャット内にツール実行の内容が折りたたまれたブロックとして表示され、実行結果もその場で確認できます。

実際にClaude Desktopで以下のように操作できます。

list_databases

search_records

update_record

get_open_logs

まとめ

今回は、SPIRAL ver.2のAPIをMCPサーバーとして実装し、Claude DesktopからAIで自然言語操作できる仕組みを構築しました。
一度MCPサーバーを実装すれば、Claude Desktop・Claude Codeなど複数のAIクライアントから共通して利用でき、非エンジニアのスタッフでもSPIRALのデータを自然言語で参照・更新できる社内ツールとして活用できます。

不具合が発生した場合は以下を確認してください。

claude_desktop_config.json

args

dist/index.js

dist

C:

SPIRAL_MCP_LOG_FILE

SPIRAL_HTTP_TIMEOUT_MS

SPIRAL_BASE_URL