ログイン無料で始める

著者 Kirill Markin

Claude Code、Codex、OpenClaw から Flashcards にログインする方法

いまでも多くのログインフローは、最初から最後まで人が手でセットアップする前提のままです。

ログイン画面を開く。コードを待つ。トークンをコピーする。API キーを作る。別のツールに貼り付ける。エージェントにドキュメントを説明する。何かおかしくなったらセッションを手で直す。

本来、こういう作業こそツールが肩代わりすべきです。

Flashcards では、1 つのディスカバリー URL から始められる、オープンソースのエージェント向けログインフローを公開しています。

https://api.flashcards-open-source-app.com/v1/

これが正式な入口です。同じディスカバリー応答は https://api.flashcards-open-source-app.com/v1/agent でも取得できますが、現行の仕様では /v1/ を起点にします。

この URL を Claude Code、Codex、OpenClaw に渡せば、エージェントはフローを確認し、メールコードの送信を始め、コードを検証し、API キーを保存し、アカウント情報を読み込み、そのままワークスペースの準備まで自力で進められます。

人間がやることは 2 つだけです。

  • メールアドレスを伝える
  • メールに届いた最新の 8 桁コードを返す

それだけです。

1 つのリンクで始められる

ディスカバリーエンドポイントは、サービスの説明、認証方式、最初の操作、次の手順を 1 つのレスポンスにまとめて返します。

そのため、ツールごとに専用の案内文を書く代わりに、エージェントへ URL を渡し、返ってきた指示どおりに進めさせれば済みます。

GET https://api.flashcards-open-source-app.com/v1/

大まかに言うと、エージェントはここで次の 4 点をすぐ把握できます。

  • これは Flashcards のサービスである
  • ログインと登録はどちらもメール OTP で行う
  • 検証に成功すると長期利用できる API キーが返る
  • ログイン後はアカウント情報の読み込みとワークスペース初期化に進む

フロー全体の流れ

手順は意図的に絞っています。

  1. エージェントがディスカバリーエンドポイントを呼ぶ
  2. エージェントがユーザーのメールアドレスを send-code に送信する
  3. Flashcards が 8 桁コードをメールで送り、otpSessionToken を返す
  4. エージェントがユーザーに最新のコードを尋ねる
  5. エージェントがコードを検証し、長期利用できる API キーを受け取る
  6. /v1/agent/me と /v1/agent/workspaces を呼ぶ
  7. 適切なワークスペースを作成または選択し、/v1/agent/sql に進む

大事なのは、エージェントが「ログインできた」で止まらないことです。残りのセットアップもそのまま進めて、実際の読み書きまで続けられます。

Claude Code や Codex に渡すプロンプト例

これだけで十分です。

次の Flashcards のディスカバリー URL を使ってください:
https://api.flashcards-open-source-app.com/v1/

Flashcards アカウントにログインして、アカウント情報を読み込み、適切なワークスペースを選ぶか作成してください。
フロー上で必要になったときだけ、メールに届いた最新の 8 桁コードを私に聞いてください。

そのあとに認証手順を人が細かく説明する必要はありません。このエンドポイントがすでにそれを伝えています。

OpenClaw に渡すプロンプト例

考え方は同じで、少しだけ具体的にします。

次の URL を使って私の Flashcards アカウントに接続してください:
https://api.flashcards-open-source-app.com/v1/

返ってきた指示に従い、API キーは安全に扱い、私のアカウント情報を読み込んでからワークスペースの準備に進んでください。
認証が必要になったら、メールに届いた最新の 8 桁コードを聞いてください。

例: ディスカバリー応答

最初のリクエストはこれです。

curl https://api.flashcards-open-source-app.com/v1/

レスポンスは、ターミナルで動くエージェントが推測せずに辿れる形になっています。

{
  "ok": true,
  "data": {
    "service": {
      "name": "flashcards-open-source-app",
      "version": "v1",
      "description": "Offline-first flashcards service with user-owned workspaces and a compact SQL agent surface."
    },
    "authentication": {
      "type": "email_otp_then_api_key",
      "sendCodeUrl": "https://auth.flashcards-open-source-app.com/api/agent/send-code",
      "verifyCodeUrl": "https://auth.flashcards-open-source-app.com/api/agent/verify-code"
    },
    "capabilitiesAfterLogin": [
      "Load account context",
      "Select a workspace",
      "Inspect runtime discovery and the published SQL surface through SQL introspection",
      "Read and write cards and decks through /agent/sql"
    ],
    "authBaseUrl": "https://auth.flashcards-open-source-app.com",
    "apiBaseUrl": "https://api.flashcards-open-source-app.com/v1",
    "surface": {
      "accountUrl": "https://api.flashcards-open-source-app.com/v1/agent/me",
      "workspacesUrl": "https://api.flashcards-open-source-app.com/v1/agent/workspaces",
      "sqlUrl": "https://api.flashcards-open-source-app.com/v1/agent/sql"
    }
  },
  "instructions": "Start with POST https://auth.flashcards-open-source-app.com/api/agent/send-code using the user's email, then POST https://auth.flashcards-open-source-app.com/api/agent/verify-code to obtain an API key. After login, call GET https://api.flashcards-open-source-app.com/v1/agent/me, then GET https://api.flashcards-open-source-app.com/v1/agent/workspaces?limit=100. If no workspace is selected for this API key, call POST https://api.flashcards-open-source-app.com/v1/agent/workspaces/{workspaceId}/select or create one with POST https://api.flashcards-open-source-app.com/v1/agent/workspaces using {\"name\":\"Personal\"}. After workspace bootstrap, use POST https://api.flashcards-open-source-app.com/v1/agent/sql for all shared card and deck reads and writes. Use docs.discoveryUrl for runtime discovery and docs.source.agentRoutesUrl for implementation details. The SQL surface is intentionally limited and is not full PostgreSQL.",
  "docs": {
    "discoveryUrl": "https://api.flashcards-open-source-app.com/v1/",
    "docsUrl": "https://flashcards-open-source-app.com/ja/docs/",
    "source": {
      "agentRoutesUrl": "https://github.com/kirill-markin/flashcards-open-source-app/tree/main/apps/backend/src/routes"
    }
  }
}

例: メールコードを送る

エージェントがユーザーのメールアドレスを受け取ったら、OTP の手順を始めます。

curl -X POST https://auth.flashcards-open-source-app.com/api/agent/send-code \
  -H "Content-Type: application/json" \
  -d '{
    "email": "you@example.com"
  }'

サーバーはメールを送り、短時間だけ有効な認証セッションを返します。

{
  "ok": true,
  "data": {
    "email": "you@example.com",
    "otpSessionToken": "...",
    "expiresInSeconds": 180,
    "authBaseUrl": "https://auth.flashcards-open-source-app.com",
    "apiBaseUrl": "https://api.flashcards-open-source-app.com/v1"
  },
  "instructions": "A verification code has been sent to the user's email. Ask for the 8-digit code from the email, then call verify_code with code, otpSessionToken, and a label for this agent connection. Read payload from data.* and do not expect resource fields at the top level. Select the next endpoint from instructions and confirm it with actions. Use docs.discoveryUrl for runtime routes and docs.source.authRoutesUrl for implementation details.",
  "docs": {
    "discoveryUrl": "https://api.flashcards-open-source-app.com/v1/",
    "source": {
      "authRoutesUrl": "https://github.com/kirill-markin/flashcards-open-source-app/tree/main/apps/auth/src/routes/agent"
    }
  }
}

この時点でエージェントが止まるのは、受信トレイに届いた最新のコードをユーザーに聞く短いあいだだけです。

例: コードを検証して API キーを受け取る

ユーザーがメールコードを返したら、エージェントはログインを最後まで完了できます。

curl -X POST https://auth.flashcards-open-source-app.com/api/agent/verify-code \
  -H "Content-Type: application/json" \
  -d '{
    "code": "12345678",
    "otpSessionToken": "...",
    "label": "Claude Code on MacBook"
  }'

検証に成功すると、長期利用できる API キーと次の手順が返ります。

{
  "ok": true,
  "data": {
    "apiKey": "fca_ABCDEFGH_0123456789ABCDEFGHJKMNPQRS",
    "authorizationScheme": "ApiKey",
    "apiBaseUrl": "https://api.flashcards-open-source-app.com/v1",
    "connection": {
      "connectionId": "connection-1",
      "label": "codex-import-bot",
      "createdAt": "2026-03-11T08:55:00.000Z",
      "lastUsedAt": null,
      "revokedAt": null
    }
  },
  "instructions": "Store this API key outside chat memory now. Use it in the Authorization header as 'ApiKey <key>'. Next call GET /v1/agent/me to load account context. Then call GET /v1/agent/workspaces?limit=100. If exactly one workspace exists, select it if needed. If no workspace exists, create one with POST /v1/agent/workspaces using {\"name\":\"Personal\"}. After a workspace is selected, use POST /v1/agent/sql for all data access. Use docs.discoveryUrl for runtime routes and docs.source.authRoutesUrl for implementation details.",
  "docs": {
    "discoveryUrl": "https://api.flashcards-open-source-app.com/v1/",
    "source": {
      "authRoutesUrl": "https://github.com/kirill-markin/flashcards-open-source-app/tree/main/apps/auth/src/routes/agent"
    }
  }
}

ここが、エージェントの関心が認証から実際のアカウント利用へ切り替わる地点です。

このキーは、すぐにチャット履歴の外へ保存してください。いちばん分かりやすいのは、一度 export してエージェントに再利用させるやり方です。

export FLASHCARDS_OPEN_SOURCE_API_KEY="fca_ABCDEFGH_0123456789ABCDEFGHJKMNPQRS"

例: アカウント情報を読み込み、ワークスペースへ進む

次のリクエストは、通常の認証付き API 呼び出しです。

curl https://api.flashcards-open-source-app.com/v1/agent/me \
  -H "Authorization: ApiKey YOUR_API_KEY"

レスポンスは、そのままワークスペースの準備へ進むようエージェントに伝えます。

{
  "ok": true,
  "data": {
    "userId": "user-123",
    "selectedWorkspaceId": null,
    "authTransport": "api_key",
    "profile": {
      "email": "you@example.com",
      "locale": "en",
      "createdAt": "2026-03-10T12:00:00.000Z"
    }
  },
  "instructions": "Next call GET https://api.flashcards-open-source-app.com/v1/agent/workspaces?limit=100 to inspect available workspaces for this API key. If data.nextCursor is not null, continue with the same endpoint and cursor=data.nextCursor until it becomes null. If no workspace is selected, call POST https://api.flashcards-open-source-app.com/v1/agent/workspaces/{workspaceId}/select. If no workspace exists, create one with POST https://api.flashcards-open-source-app.com/v1/agent/workspaces using {\"name\":\"Personal\"}. After a workspace is selected, use POST https://api.flashcards-open-source-app.com/v1/agent/sql for reads, writes, and SQL introspection. Read payload from data.* and use docs.discoveryUrl for runtime routes and docs.source.agentRoutesUrl for implementation details.",
  "docs": {
    "discoveryUrl": "https://api.flashcards-open-source-app.com/v1/",
    "source": {
      "agentRoutesUrl": "https://github.com/kirill-markin/flashcards-open-source-app/tree/main/apps/backend/src/routes"
    }
  }
}

ここから先、エージェントは次のことができます。

  • 利用可能なワークスペースをすべて読み込む
  • まだ存在しなければ最初のワークスペースを作る
  • 複数ある場合は正しいワークスペースを選ぶ
  • /v1/ のディスカバリでランタイムルートを確認する
  • POST /v1/agent/sql で読み取り、書き込み、SQL の内省を行う

つまり、このログインフローは理屈のうえで正しいだけでなく、実際に使えるところまでつながっています。

OpenAPI は利用できず、/v1/ がランタイムディスカバリのエントリポイントです。4 つの旧仕様パス /v1/openapi.json、/v1/swagger.json、/v1/agent/openapi.json、/v1/agent/swagger.json は、スキーマではなく openapiAvailable: false を含む同じ JSON ディスカバリ通知を返します。

手動で API キーを用意するより、この方法がよい理由

よくある API 導入の流れは、まだかなり面倒です。

  • ブラウザでログインする
  • 設定画面を開く
  • 手作業でトークンを作る
  • それを別のツールへコピーする
  • そのツールが次に何をすべきか分かるよう、ドキュメントを開いたままにしておく

このフローなら、その大半を省けます。

ユーザーはメール OTP で本人確認を行い、サービスは長期利用できる API キーを直接エージェントへ発行します。そして同じレスポンス形式のまま、次に何をすべきかをエージェントへ示し続けます。

そのほうがユーザーにとって単純で、自動化もしやすくなります。

これはオープンソースです

Flashcards はオープンソースなので、ブラックボックスとして扱うのではなく、フロー全体を自分で確認できます。

オープンソースの API 認証、メール OTP ログイン、エージェント向けオンボーディング設計に関心があるなら、まず読むべきなのはこれらのファイルです。

試してみる

このフローを試すなら、エージェントに次の URL を渡してください。

https://api.flashcards-open-source-app.com/v1/

あとはエージェントに任せれば済みます。

参考リンク:

プロダクトがオープンソースで、認証フローが十分に絞られていれば、「エージェントに任せる」は本当に機能するはずです。このフローは、そのために作られています。

次に読む

2026年版 プライベートなフラッシュカード: 主導権を手放さずにAIで学ぶ方法

2026年にフラッシュカードをプライベートに保つには何が必要か。オープンソース、オフラインファーストの間隔反復、任意利用のAI、セルフホストの選択肢まで含めて整理します。

間隔反復に対応したセルフホスト可能なオープンソースのFlashcardsアプリ

オープンソースのFlashcardsスタックを開発用にローカルでセルフホストするか、文書化されたAWS CDKインフラをデプロイして本番用の間隔反復アプリを運用できます。

2026年版 Claudeで勉強する方法：家庭教師からフラッシュカードにつなぐ学習法

Claudeを家庭教師として使い、実際につまずいた点を見つけ、選んだカードだけをMCP経由でFlashcardsに保存して、あとからFSRSで復習する方法を紹介します。

Knowtの代替アプリ（2026年版）：KnowtとFlashcardsを比較

KnowtとFlashcardsを比較。AIノート、Learn Mode、Practice Test、FSRS、オフライン学習、オープンソース、セルフホスティング、データ管理の違いを解説します。