QuiQSol

@quiqsol/mcp

QuiQSol を Claude、ChatGPT、Cursor、その他あらゆる AI エージェントに接続します。

このパッケージでは、次の 2 つを利用できます。

• quiqsol mcp：stdio 経由のローカルな Model Context Protocol サーバーです。コマンドを起動するアプリ（Claude Desktop、Claude Code、Cursor、Windsurf、VS Code）向けです。
• quiqsol：ターミナル、スクリプト、エージェント向けのコマンドラインツールです。JSON を出力します。

どちらも https://api.quiqsol.com/mcp の QuiQSol リモート MCP サーバー上で動作します。ツール、権限、安全ルールはサーバー側にあるため、このパッケージは小さく、依存関係はゼロで、新しいツールを利用するために更新する必要もありません。

MIT ライセンスです。

エージェントでできること

製品	読み取り	操作
CRM	リード、連絡先、会社、取引、メモ、タスクの検索・一覧表示・取得、パイプラインの表示	リード、連絡先、会社、取引の作成と更新、取引ステージの変更、メモの追加、タスクの作成と完了
ヘルプデスク	チケットの一覧表示と会話全体の閲覧	返信（事前にプレビュー）、内部メモの追加、ステータスの変更
受信トレイ	WhatsApp、ウェブサイトのチャット、ソーシャルメディア全体の会話の一覧表示、メッセージの閲覧	WhatsApp の 24 時間以内のウィンドウで返信（事前にプレビュー）
請求書	請求書と合計金額の一覧表示と閲覧	請求書の下書き作成、送信（事前にプレビュー）
プロジェクト	プロジェクトとタスクの一覧表示	タスクの作成と更新
フォーム	フォームと送信内容の一覧表示
分析	ビジネス概要、売上、ヘルプデスク、請求書の概要

セキュリティモデル

• スコープによるアクセス制御。 すべてのキーと接続には明示的なスコープ（crm:read、crm:write、helpdesk:read、helpdesk:write、inbox:read、inbox:send、invoices:read、invoices:write、invoices:send、projects:read、projects:write、forms:read、analytics:read）が設定されています。エージェントには、許可されたスコープに対応するツールのみが表示されます。
• ユーザー自身の権限を適用。 エージェントは、キーを作成した人、または接続を承認した人として、その人のロールの範囲内で操作します。アプリ上でその人に許可された以上の操作はできません。
• 承認なしに顧客へ送信されることはありません。 チケットへの返信、受信トレイからの返信、請求書の送信では、まずプレビューが返されます。confirm: true を指定して再度呼び出した場合にのみ送信されます。エージェントは、ユーザーの承認後にのみ再度呼び出すよう指示されています。
• 信頼できないコンテンツにはラベルが付けられます。 すべての結果はワークスペースデータとしてラップされ、顧客が書いたテキストは指示ではなくデータとしてマークされます。
• 出力にシークレットは含まれません。 トークン、ハッシュ、キーはすべて、サーバー側ですべての結果から取り除かれます。
• 取り消し可能で、監査できます。 Settings > Developer Platform でキーや接続を取り消せます。すべての呼び出しは、そこで API アクティビティログに記録されます。

キーを取得する

QuiQSol で Settings > Developer Platform > AI agents を開き、Create AI agent key を選択してスコープを選び、キーをコピーします（キーが表示されるのは一度だけです）。

Claude と ChatGPT ではキーは不要です。コネクターとして https://api.quiqsol.com/mcp を追加し、OAuth でサインインしてください。セットアップガイドを参照してください。

Claude Desktop、Cursor、その他の stdio MCP クライアントで使用する

{
  "mcpServers": {
    "quiqsol": {
      "command": "npx",
      "args": ["-y", "@quiqsol/mcp", "mcp"],
      "env": { "QUIQSOL_API_KEY": "aur_live_..." }
    }
  }
}

Claude Desktop：Settings > Developer > Edit Config。Cursor：~/.cursor/mcp.json または Settings > MCP。

リモートサーバーに対応するクライアントでは、パッケージを使わずにサーバーを直接指定できます。

{
  "mcpServers": {
    "quiqsol": {
      "url": "https://api.quiqsol.com/mcp",
      "headers": { "Authorization": "Bearer aur_live_..." }
    }
  }
}

Claude Code：

claude mcp add --transport http quiqsol https://api.quiqsol.com/mcp

CLI を使用する

npm install -g @quiqsol/mcp
quiqsol login
quiqsol whoami

quiqsol leads list --status NEW --limit 10
quiqsol leads create --first-name Ada --last-name Obi --email [email protected] --source WEBSITE
quiqsol deals pipeline
quiqsol deals move 66f0c2aa66f0c2aa66f0c2aa "Proposal sent"
quiqsol tickets list --status OPEN --mine
quiqsol tickets reply 66f0c2aa66f0c2aa66f0c2aa --body "Your refund was processed today."
quiqsol inbox list --channel whatsapp --unread
quiqsol invoices create --contact-id 66f0c2aa66f0c2aa66f0c2aa --item "Website design:1:450000" --due-date 2026-11-30
quiqsol invoices send 66f0c2aa66f0c2aa66f0c2aa
quiqsol analytics overview --days 30

ツールを名前で指定して実行する場合：

quiqsol tools
quiqsol call crm_list_deals '{"stage":"Negotiation","limit":5}'

出力は stdout に JSON 形式で出力されます（ターミナルでは整形され、パイプ経由ではコンパクトになります）。顧客に連絡するコマンドは、プレビューを表示して送信前に確認を求めます。スクリプトではプレビューを出力して終了コード 3 で終了します。--yes を渡すと確認を省略できます。

終了コード	意味
0	完了
1	エラー（メッセージは stderr に出力）
2	使用方法のエラー
3	プレビューのみ。何も送信されていません

設定：QUIQSOL_API_KEY と QUIQSOL_API_URL は、~/.config/quiqsol/config.json に保存されたログイン情報を上書きします（このファイルは所有者のみがアクセスできる権限で書き込まれます）。

コードから使用する

const { QuiqsolClient } = require('@quiqsol/mcp');

const quiqsol = new QuiqsolClient({ apiKey: process.env.QUIQSOL_API_KEY });
const { data } = await quiqsol.callTool('crm_list_leads', { status: 'NEW', limit: 5 });

プレーンな HTTP をお好みですか？ 同じツールを https://api.quiqsol.com/public/v1/agent の REST API（GET /tools、POST /tools/{name}）からも利用できます。

要件

Node.js 18 以降。

ライセンス

MIT。QuiQSol プラットフォーム自体は商用サービスですが、このコネクターはオープンソースなので、お使いのマシンで実行される内容を正確に確認できます。