ActTrace

ActTrace

非金融系の SaaS 企業およびテクノロジー企業向けの、開発者向けEU AI 法コンプライアンス APIです。ActTrace は、エンジニアリングチームに次の 3 つを、API または MCP 経由でセルフサービスで提供します。

1. EU AI 法に基づく AI 機能の決定論的なリスク分類。
2. すぐに公開できる第 50 条の透明性に関する通知。
3. 公開時の窓口となる無料の診断。

法的助言ではありません。 ActTrace は、運用上のコンプライアンスワークフローのサポートと文書ドラフトを提供します。法的助言を行うものではなく、コンプライアンスを認証するものでも、資格を有する弁護士による審査に代わるものでもありません。すべての応答にこの免責事項が記載されます。

ActTrace は非金融系企業を対象としています。金融サービスに関するユースケース（銀行業務、取引、ポートフォリオ／投資助言、信用スコアリングなど）は、意図的に out_of_scope_financial_services に分類されます。

インストール — Claude Code プラグイン／MCP サーバー

ActTrace は、acttrace スキルとローカル MCP サーバーを含む Claude Code プラグインとして提供されます。MCP サーバーは uvx 経由で実行されます。決定論的なルールエンジンであり、オフラインで動作し、API キーは不要です。

/plugin marketplace add goww7/acttrace
/plugin install acttrace@acttrace

その後、Claude に 「自社のチャットボットは EU AI 法に準拠していますか？」 または 「サポートアシスタント向けの第 50 条通知を書いてください。」 と尋ねてください。MCP サーバーは、uvx acttrace-mcp を使って、任意の MCP クライアントから単独で実行することもできます。

クイックスタート

python3 -m venv .venv && .venv/bin/pip install -r requirements.txt
.venv/bin/uvicorn acttrace.app:app --reload --port 8080

# 1. Free diagnostic — no key needed
curl -s localhost:8080/api/acttrace/diagnostics/free -H 'content-type: application/json' -d '{
  "feature_name": "AI reply assistant",
  "description": "Drafts suggested customer support replies for agents.",
  "user_facing": true, "model_provider": "OpenAI", "use_case": "support_assist"
}'

# 2. Mint an API key
KEY=$(curl -s -XPOST localhost:8080/api/keys/generate | python3 -c 'import sys,json;print(json.load(sys.stdin)["api_key"])')

# 3. Classify (15 tokens)
curl -s localhost:8080/api/acttrace/classify -H "X-API-Key: $KEY" -H 'content-type: application/json' -d '{
  "feature_name": "AI reply assistant",
  "description": "Drafts customer support replies shown to agents.",
  "use_case": "support_assist", "user_facing": true, "model_provider": "OpenAI"
}'

# 4. Generate an Article 50 notice (10 tokens)
curl -s localhost:8080/api/acttrace/notices -H "X-API-Key: $KEY" -H 'content-type: application/json' -d '{
  "ai_system_name": "Support Copilot", "notice_type": "chatbot", "tone": "plain"
}'

エンドポイント

メソッドとパス	認証	トークン	目的
POST /api/acttrace/diagnostics/free	なし	0	公開リスク診断
POST /api/acttrace/classify	キー	15	文書化されたリスク分類
POST /api/acttrace/notices	キー	10	第 50 条の透明性に関する通知
POST /api/keys/generate	なし	0	無料プランのキーを発行
GET /api/health	なし	0	稼働状態

認証には X-API-Key を使用します。応答には X-Request-ID、X-Plan、 X-Tokens-Charged、X-Tokens-Remaining、X-RateLimit-* が含まれます。エラーは {"code","message","detail"} の形式で構造化されています（401／403／429）。

MCP

python -m acttrace.mcp_server --sse --port 8002 を実行すると、acttrace_classify と acttrace_generate_transparency_notice の 2 つのツールが公開されます。認証には同じ X-API-Key を使用します。Claude Code スキルは skill/acttrace/ にあります。

テスト

.venv/bin/python -m pytest -q

54 件のテストがあります。分類エンジン（7 件の受け入れテスト用フィクスチャ）、競合ガード、通知ジェネレーター、HTTP API 契約を対象としています。

デプロイ

docker-compose.yml は、専用ボリュームを備えたスタンドアロンの 2 コンテナ構成（API と MCP）をポート 8080／8002 でビルドします。FinanceData2 からは分離されています。本番環境で公開するには、共有 Caddyfile に caddy-acttrace.snippet を追記してください（プレースホルダーのドメインを置き換えてください）。ビルド契約の全容については BLUEPRINT.md を参照してください。

ディレクトリ構成

acttrace/
  app.py config.py dependencies.py
  middleware/   api_key_auth.py
  routers/      acttrace.py  keys.py
  services/     acttrace_service.py  acttrace_classification_service.py
                acttrace_notice_service.py  acttrace_constants.py
                api_key_service.py
  repositories/ acttrace_repository.py  api_key_repository.py
  schemas/      acttrace.py
  mcp_server/   server.py  __main__.py  context.py  tools/acttrace.py
skill/acttrace/ SKILL.md  README.md
tests/