Ninchi CLI & MCP

1. ダッシュボード URL の /dashboard/orgs/ に続くセグメントが組織 ID です。数値 ID（42）と組織の UUID 形式のパブリック ID のどちらも使用できます。新しいダッシュボード URL は UUID 形式ですが、既存設定の数値 ID も引き続き有効です。現在 CLI には組織一覧コマンドがありません。
2. 組織管理者に、組織設定の Programmatic Checks (CLI & MCP) を開き、「Enable CLI & MCP check submission」を有効にしてもらいます。
3. プログラムによるチェックのクォータは、開発者ごとの直近 30 日間に対するハード上限です。429 応答には次のチェックが利用可能になる時刻が含まれます。

pipx install ninchi-cli

pipx アプリケーションをシェルの PATH に追加し、新しいシェルを開いて実行ファイルを確認します。

pipx ensurepath
# Close and reopen your shell, then verify:
command -v ninchi
ninchi --help

command -v ninchi
# Use the printed absolute path in your MCP configuration.

ninchi login

1. CLI に確認 URL と XXXX-XXXX 形式の 8 文字コードが表示されます。
2. URL を開いてサインインし、/dashboard/device でコードを承認します。
3. CLI は承認までポーリングし、発行された個人アクセストークンを保存します。

認証情報はファイルモード 0600 で ~/.config/ninchi/credentials に保存されます。NINCHI_CONFIG_DIR または XDG_CONFIG_HOME で保存場所を変更できます。

CI と手動作成トークン

export NINCHI_API_TOKEN="ninchi_pat_..."
export NINCHI_ORG_ID=42

CI ではトークンを NINCHI_API_TOKEN として保存します。PAT の作成・失効は /dashboard/profile で行います。既定で checks:read と checks:write スコープを持ち、平文は一度だけ表示され、Ninchi 側では HMAC ダイジェストとして保存されます。失効後は直ちに利用できなくなります。

# Working-tree diff (default)
ninchi check --org-id 42

# Other subject sources
git diff | ninchi check --stdin --org-id 42
ninchi check --staged --org-id 42
ninchi check --commit HEAD --org-id 42
ninchi check --file src/app.py --language python --org-id 42

# Reuse the org ID from your environment
export NINCHI_ORG_ID=42
ninchi check --staged

# Automation: answer non-interactively and emit JSON
ninchi check --staged \
  --answer "$ANSWER" \
  --actor agent_assisted \
  --json

# Inspect an existing challenge
ninchi result CHALLENGE_ID
ninchi result CHALLENGE_ID --json
ninchi history --limit 20
ninchi history --limit 20 --json

login は --timeout、--api-url、--json に対応します。check は --poll-interval と --timeout にも対応します。result にはチャレンジ ID を渡し、history では --limit を指定できます。--json はサブコマンドの後に置いてください。

pre-push フック

#!/usr/bin/env bash
set -euo pipefail

base="${NINCHI_BASE_REF:-origin/main}"
git diff --patch "$base"...HEAD | ninchi check \
  --stdin \
  --org-id "${NINCHI_ORG_ID:?set NINCHI_ORG_ID}"

.git/hooks/pre-push として保存し、実行権限を付与します。人がターミナルで対話的に回答する場合は --answer を指定しません。

最小構成の GitHub Actions ジョブ

name: Ninchi check
on:
  pull_request:

jobs:
  ninchi:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0
      - uses: actions/setup-python@v5
        with:
          python-version: "3.12"
      - run: pipx install ninchi-cli
      - name: Submit Ninchi check and surface the challenge
        run: |
          git diff --patch origin/${{ github.base_ref }}...HEAD |
            ninchi check --stdin --json | tee ninchi-challenge.json || true
        env:
          NINCHI_API_TOKEN: ${{ secrets.NINCHI_API_TOKEN }}
          NINCHI_ORG_ID: ${{ vars.NINCHI_ORG_ID }}

CLI は公開 PyPI から直接インストールします。認証情報はワークフローファイルではなく GitHub Secrets に保存してください。このジョブは意図的に提出までで止まります。--answer を指定しない場合、CLI はチャレンジの JSON を出力して終了コード 2 で終了します。回答は変更を作成した本人が行う必要があります。たとえば pre-push フックや MCP 対応エディタで対話的に回答してください。定型回答を CI に組み込まないでください。質問は提出ごとに生成され、回答時間はチャレンジが最初に表示された時点から始まります。

基本設定では実行ファイルの絶対パスを使用します。プレースホルダーを command -v ninchi の出力に置き換えてください。

{
  "mcpServers": {
    "ninchi": {
      "command": "/absolute/path/from/command-v-ninchi",
      "args": ["mcp"]
    }
  }
}

エディタが ninchi を含む PATH を確実に引き継ぐ場合に限り、コマンド名だけを使用できます。

{
  "mcpServers": {
    "ninchi": {
      "command": "ninchi",
      "args": ["mcp"]
    }
  }
}

MCP の提出には client_attribution: "mcp:<client>" が付与されます。これは提出チャネルを示し、検出可能な範囲の下限として AI 作成分析に利用されますが、それだけで AI 支援があったと断定するものではありません。

解決しない場合は サポート にアクセスし、可能であれば応答の X-Request-ID を添えてください。