Claude コネクター

​

概要

SankaのClaudeコネクターを使えば、Claudeの会話内で自然言語を使って取引、連絡先、企業、請求書などを管理できます。OAuthで一度接続すれば、すぐに使い始められます。 SankaをAIで使う3つの方法： このページではClaudeコネクターについて説明します。MCPとSDKについてはクイックスタートをご覧ください。

---

​

SankaをClaudeに接続する

1. Claude → Settings → Connectors を開く
2. Sanka を見つけて Connect をクリック
3. Sankaのワークスペースにログインし、権限を付与
4. 完了 — Claudeからあなたのデータにアクセスできるようになりました

OAuthフローはPKCEを使用しています（クライアントシークレット不要）。Claudeがリフレッシュトークンを保存するため、セッション間で接続が維持されます。

​

スコープ

接続時にClaudeに以下のアクセスを許可できます：

• 取引、連絡先、企業 — 作成、読み取り、更新
• 請求書、見積書、注文 — 作成、読み取り、更新
• サブスクリプション、支払い、仕入先請求 — 請求ライフサイクルの管理
• 商品、在庫 — 在庫レベルと商品カタログの読み取り
• ワークフロー — 自動化のトリガーと管理
• レポート — ビジネス指標のクエリ

Sankaの開発者設定から、いつでもアクセスを取り消せます。

---

​

使用例

​

例1：取引の作成とエンリッチメント

Claudeに新しい取引の作成と企業データの自動エンリッチメントを依頼：

「jane@acme-corp.com の取引を作成して。50人の営業チーム向けにプラットフォームを評価中です。業界やテックスタックを把握するために企業データをエンリッチして。」

裏側で起こること：

1. Claudeが execute を呼び出し、jane@acme-corp.com のコンタクトを作成
2. Claudeが execute を呼び出し、企業（acme-corp.com）をエンリッチ — 業界、従業員数、テックスタック、資金調達データを取得
3. Claudeが execute を呼び出し、コンタクトとエンリッチされた企業に紐づいた取引を作成
4. 取引の詳細とエンリッチされた企業情報の要約を返す

結果： 企業のファーモグラフィックデータ付きの完全にエンリッチされた取引レコードが、会話を離れることなく数秒で作成されます。

---

​

例2：パイプラインレビュー（フィルター付き）

Claudeに現在のパイプラインの分析を依頼：

「今月クローズ予定で¥1,000,000以上の取引を全部見せて。クローズ日順に並べて、過去7日間更新されていないものにフラグを立てて。」

裏側で起こること：

1. Claudeが execute を呼び出し、日付と金額のフィルターで取引を一覧
2. Claudeが結果を処理し、最終更新日をチェック
3. 滞留フラグ付きのフォーマット済みテーブルを返す

結果： アクション可能なフラグ付きのパイプラインサマリー — ダッシュードの切り替え不要。

---

​

例3：成約した取引への請求

取引が成約したらClaudeに請求書の生成を依頼：

「株式会社アクメの取引が年間¥2,400,000で成約しました。NET30条件で請求書を作成して、経理担当者に送信してください。」

裏側で起こること：

1. Claudeが execute を呼び出し、取引と関連コンタクトを取得
2. Claudeが execute を呼び出し、取引金額、NET30条件、経理担当者で請求書を作成
3. 送信前にレビューできるよう請求書の詳細とリンクを返す

結果： 取引に紐づいたドラフト請求書がレビュー可能な状態で作成されます。

---

​

例4：リードスコアリング

Claudeにリードのスコアリングと優先順位付けを依頼：

「今週追加されたすべてのコンタクトをICPフィットでスコアリングして。理想的な顧客は、従業員50〜500人の日本のB2B SaaS企業です。」

裏側で起こること：

1. Claudeが execute を呼び出し、最近作成されたコンタクトを一覧
2. Claudeが execute を呼び出し、各コンタクトの企業データをエンリッチ
3. Claudeが execute を呼び出し、ICP基準に対して各コンタクトをスコアリング
4. スコアと理由付きのランク付きリストを返す

結果： エンリッチメントデータとフィットスコア付きの優先順位付きリードリスト。

---

​

利用可能なツール

コネクターは2つのMCPツールを公開しています：

​

execute

サンドボックス環境でSanka SDKに対してJavaScript/TypeScriptコードを実行します。これが主要なツールで、あらゆるSanka APIエンドポイントを呼び出せます。

• アノテーション: readOnlyHint: false, destructiveHint: true
• 機能: すべてのSankaリソース（取引、連絡先、請求書など）に対するフルCRUD
• セキュリティ: コードは隔離されたDenoサブプロセスで実行され、ネットワークアクセスはSanka APIに限定

​

search_docs

Sanka SDKのドキュメントを検索し、メソッド、パラメータ、使用例を見つけます。

• アノテーション: readOnlyHint: true
• 用途: Claudeがコードを書く前に適切なAPIメソッドを見つけるために使用

---

​

技術詳細

​

OAuth設定

​

MCP サーバー

​

プライバシーとセキュリティ

• プライバシーポリシー: sanka.io/privacy
• データ処理: Claudeはユーザーに代わってSankaにAPIリクエストを送信します。コネクターはOAuthトークン以外のデータを保存しません。
• トークン保存: OAuthトークンはClaude側で管理され、自動的に更新されます。
• 取り消し: Sankaの開発者設定から、いつでもアクセスを取り消せます。

---

​

トラブルシューティング

「App is not installed」 ワークスペース管理者がClaudeコネクターを有効にする必要があります。Sanka → 設定 → 連携 → Claude で「インストール」をクリックしてください。 「Requested scopes not approved」 ワークスペース管理者がClaudeコネクターで使用できるスコープを制限している可能性があります。必要なスコープの承認を管理者にお問い合わせください。 「Origin not allowed」 通常、設定の問題を示しています。Sankaサポートにお問い合わせください。 トークン期限切れエラー Claudeはトークンを自動的に更新します。認証エラーが続く場合は、Claude Settings でSankaコネクターを切断して再接続してください。