コネクタ

コネクタは、あなたのベンチャーがすでに使っているツール — 決済プロセッサ、銀行、クラウドプロバイダー、広告プラットフォーム、AI API — からデータを同期します。これにより収益とコストが自動的に Kordox に流れ込み、実際のベンチャー別利益になります。

コネクタが取得するものはすべて 読み取り専用 です。Kordox はお金を動かしたり、設定を変更したり、接続されたアカウントに何かを書き戻したりすることは一切ありません。

コネクタの仕組み

流れはどのプロバイダーでも同じです:

1. 追加 — ベンチャーを開く → コネクタ タブ（または ファイナンス → データソース）で ソースを接続 をクリックし、プロバイダーを選びます。
2. 承認 — ワンクリック OAuth（プロバイダー自身の画面で読み取りアクセスを承認）か、プロバイダーのダッシュボードで作成した API キー / トークン を貼り付けます。パネルには正確な手順が表示され、該当ページへ直接リンクします。
3. 検証 — Kordox は認証情報を即座にチェックし、スコープや権限が不足していれば知らせます。
4. 初回同期 — 最初の取得が自動で実行され、直近の履歴をバックフィルします。
5. 常に最新に — Kordox はスケジュールで再同期します（約6時間ごと）。いつでも手動で 同期 することもできます。
6. 割り当て — 同期された取引は、それが属するベンチャーへ振り分けられます（ベンチャーへのお金の割り当て を参照）。

ベンチャーに限定

コネクタはベンチャーに限定されているため、各ベンチャーは自身の接続済みアカウントとデータだけを見ます。インフラや AI のコストはその後、割り当てによってベンチャー間で分割できます。

セキュリティ — 認証情報の扱い方

• 設計上、読み取り専用。 すべてのコネクタは読み取りスコープ（請求、チャージ、注文、コストレポート）のみを要求します。Kordox が保持するものは、あなたのアカウントで支払いや返金、再設定を行うことはできません。
• 保存時に暗号化。 API キーと OAuth トークンは保存前に暗号化され、保存後にブラウザへ返されることはありません。
• 最小権限。 プロバイダーがスコープ付き認証情報をサポートしている場合（Stripe の制限付きキー、Cloudflare のスコープ付きトークン、AWS の IAM ポリシー）、ガイドは動作する範囲で最も狭い権限を要求します — 以下のコネクタごとに記載しています。
• いつでも取り消し可能。 切断すると Kordox のアクセスが解除され、同期が停止します。すでに同期されたデータは元帳に残ります。

利用可能なコネクタ

カテゴリ	プロバイダー	接続方法
収益	Stripe, Shopify, PayPal, Square	OAuth（Stripe/Shopify）または API キー
現金 / 銀行	Plaid（残高がランウェイに反映）	API キー + Link トークン
インフラコスト	Cloudflare, AWS Billing, GCP Billing	API キーまたは OAuth（GCP）
広告費	Meta Ads, Google Ads	OAuth
AI・トークン	Anthropic (Claude), OpenAI	Admin API キー
メール	転送/BCC + レコードから返信	コネクタではありません — メール を参照

同期・ステータス・鮮度

• スケジュール。 Kordox はアクティブなコネクタを約6時間ごとに自動で再同期します。
• 手動同期。 コネクタの行からいつでも更新をトリガーできます（カテゴリごとの すべて同期 も可能）。手動同期は同じ取得をより早く実行するだけです。
• ステータス。 各コネクタは、最終同期時刻、直近30日間の金額と取引件数、割り当て済みの割合を表示します。
• 要対応。 失敗しているコネクタは、正確なエラーと 検証 / 同期 / 設定 のショートカット付きで先頭に表示されます。一時的な上流エラーは自動でリトライし、次のスケジュール同期で自己修復します。
• 履歴。 履歴 ボタンで直近の同期実行とその結果を確認できます。

各コネクタに必要なもの

Stripe — 決済

支払い・入金・返金・手数料をベンチャー別 P&L に同期します。読み取り専用。

• 権限: Balance, Charges, Refunds, Subscriptions の 読み取り を持つ 制限付き API キー。（クライアント請求をオンにする場合のみ Checkout Sessions に 書き込み を追加してください — 既定ではオフで、同期には不要です。）
• 手順: Stripe → Developers → API keys → 上記スコープを持つ制限付きキーを作成 → 貼り付け → アカウントを追加。お金は あなたの Stripe に入り、キーがそれを動かすことはできません。

Shopify — 注文

ストアの注文と返金を収益として同期します。読み取り専用。

• 権限（OAuth）: read_orders, read_products。
• 手順: mystore.myshopify.com ドメインを入力 → Shopify で接続 → 読み取りアクセスを承認 → 戻ると注文が収益として同期されます。
• 必要なもの: アプリをインストールできるスタッフアカウント。

PayPal — 決済

PayPal の取引を収益として同期します。

• 権限: PayPal の REST アプリ — その Client ID + Secret（Transaction Search は読み取り専用）。
• 手順: developer.paypal.com → Apps & Credentials → REST アプリを開く/作成 → Client ID + Secret をコピー → 両方を貼り付け → Live（または Sandbox）を選択 → 保存。

Square — 決済

Square の支払いと返金を収益として同期します。

• 権限: Square の アクセストークン（PAYMENTS_READ）。
• 手順: developer.squareup.com → アプリ → Credentials → アクセストークンをコピー → 貼り付け、任意で Location ID を追加して1つのロケーションに限定 → 環境を選択 → 保存。

Plaid — 銀行残高

銀行残高を接続し、ランウェイを実際の現金に基づいて算出します。

• 権限: Plaid の Client ID + Secret と、Plaid Link から取得した item アクセストークン（Balance プロダクト）。
• 手順: Plaid ダッシュボードから Client ID + Secret をコピー → Plaid Link で銀行を接続してアクセストークンを取得 → 3つすべてを貼り付け → 環境（production/sandbox）を選択 → 保存。

Cloudflare — インフラコスト

Cloudflare の利用状況と請求コストを追跡します。

• 権限: 単一の権限 Account → Billing → Read を持つカスタム API トークン（自分のアカウントに限定）。
• 手順: ダッシュボード → My Profile → API Tokens → Create Token（Billing Read）→ コピー → 貼り付け、加えて Account ID（任意のドメインの Overview 右サイドバー）→ 保存。Kordox が即座に検証します。

AWS Billing — インフラコスト

AWS のコストと使用量を正しいベンチャーの P&L に取り込みます。

• 権限: ce:GetCostAndUsage を呼び出せる IAM ユーザー/キー（AWS Cost Explorer）。マネージド AWSBillingReadOnlyAccess ポリシーでカバーできます。
• 手順: IAM → ポリシーをユーザーにアタッチ → アクセスキー を作成 → アクセスキー ID + シークレットを貼り付け → 任意でリージョンを設定（既定は us-east-1）→ 保存。

GCP Billing — インフラコスト

Google Cloud の支出を取り込み、インフラコストを正しいベンチャーの P&L に反映します — GCP プロジェクト別、サービス別、日別。

• 接続（ワンクリック）: Google アカウントで接続 を選び、GCP を所有する ID でサインインします。Kordox が請求先アカウントと BigQuery 課金エクスポートを自動検出します — ほとんどの構成では入力は不要です。
• 権限（OAuth）: cloud-billing.readonly + bigquery.readonly。
• 唯一の手動 GCP 手順: コストデータは Cloud Billing の BigQuery エクスポート から取得され、これはコンソールでのみ有効化できます — 請求 → 課金データのエクスポート → Standard usage cost → プロジェクト + データセットを選択。まだ有効でない場合、コネクタのチェックリストがそこへ直接リンクします。最初のデータは有効化から約24時間後に到着します（過去分の遡及反映はありません）。
• 高度な設定（OAuth なし）: 代わりに Billing Account Viewer + BigQuery 読み取り を持つ サービスアカウント JSON キー を貼り付け — マシンアカウントに便利です。
• GCP 側で何か変更した? カードの Google から再検出 を使って自動検出を再実行し、正しい請求先アカウントを選びます。

Meta Ads — 広告費

Meta（Facebook/Instagram）の広告費をコストとして取り込み、利益率と CAC を正確にします。

• 権限（OAuth）: ads_read。
• 手順: OAuth で接続 → 読み取りアクセスを承認 → 同期する広告アカウントを選択 → 費用が経費として取り込まれます。

Google Ads — 広告費

Google Ads の費用をコストとして取り込み、正確な利益率と CAC を実現します。

• 権限（OAuth）: Google Ads データへの読み取りアクセス。customer ID を確認します。
• 手順: OAuth で接続 → 読み取りアクセスを承認 → アカウントを選択 / customer ID を確認 → 費用が経費として取り込まれます。

Anthropic (Claude) — AI・トークン

Claude API とワークスペースの支出を、ワークスペース別に AI コストとして追跡します — 各ベンチャーの AI 費用が実態になります。

• 権限: 組織管理者 ロールと Admin API キー（sk-ant-admin…）。通常の API キーでは組織の使用状況を読み取れ ません。Kordox は日次の コストレポート のみを読み取ります。
• 手順: console.anthropic.com → Settings → Admin keys（通常の API キーのページ ではありません）→ Admin キーを作成 → ここに貼り付け。
• 割り当て: 各 Claude ワークスペースは、GCP プロジェクトとまったく同じようにベンチャーへマッピングされます。

OpenAI — AI・トークン

OpenAI API の支出を、プロジェクト別に AI コストとして追跡します。

• 権限: 組織の owner/admin ロールと Admin API キー（sk-admin…）。Kordox は日次コストのみを読み取ります。
• 手順: platform.openai.com → Settings → Organization → Admin keys → 管理者キーを作成 → ここに貼り付け。
• 割り当て: 各 OpenAI プロジェクトはベンチャーへマッピングされます。

ベンチャーへのお金の割り当て

Kordox は同期されたすべての取引を、それが属するベンチャーへ振り分けます。これにより、ベンチャー別 P&L が「どのアカウントから来たか」ではなく実態になります。どちらの仕組みも 遡及的 です — Kordox は保存して再同期すると、既存の履歴を再割り当てします。

ソースマッピング — きれいなサブエンティティを持つプロバイダー向け。GCP コストはクラウドプロジェクト別、Cloudflare はアカウント別、Claude/OpenAI はワークスペース/プロジェクト別にマッピングします。ファイナンス → クラウドコスト → 割り当て で編集します。

割り当てルール — きれいなサブエンティティを持たないプロバイダー向け（Stripe のディスクリプタ、銀行のメモ）。ルールは 「説明に X が含まれる → ベンチャー Y」 を意味します: 説明にそのテキストが含まれる取引（大文字小文字を区別しない）はそのベンチャーに割り当てられ、最初に一致したルールが優先されます。ファイナンス → マネーエクスプローラー → 割り当てルール で編集し、保存して再同期 します。

マネーエクスプローラー

ファイナンス → マネーエクスプローラー は、同期されたすべてのお金 — 収益、インフラ、広告、AI、手数料 — を、カテゴリ、プロバイダー、ソース、サービス、ベンチャー、タイプ別に、任意の期間で切り分けます。入金、出金、純額 を切り替え、現在のビューを Excel ワークブック、ブランド付き PDF レポート、または CSV としてエクスポートできます。

トラブルシューティング

• 同期エラーで「要対応」。 エラーテキストを開いてください — 上流の HTTP ステータスが含まれるようになりました。401/403 はキー/トークンに必要なスコープが不足していることを意味します（上記の権限で再作成してください）。一時的な 5xx/レート制限エラーは自動でリトライし、次のスケジュール同期でクリアされます。
• 接続済みだがデータがない。 一部のプロバイダーには遅延があります: GCP の BigQuery エクスポートは有効化から約24時間後に最初のデータが到着し、AI コストレポートは約1〜2日遅れます。1サイクル待ってから 同期 してください。
• コストが間違ったベンチャーにある。 割り当て を設定して 保存して再同期 — 新しいデータだけでなく履歴も再割り当てします。
• 検証がすぐに失敗する。 認証情報が間違っているか、スコープが不足しています。パネルが不足しているものを示します。キーを再作成して貼り付け直してください。