ログイン無料で始める

著者

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 the published SQL surface through OpenAPI and 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 https://api.flashcards-open-source-app.com/v1/agent/openapi.json for the full contract. The SQL surface is intentionally limited and is not full PostgreSQL.",
  "docs": {
    "openapiUrl": "https://api.flashcards-open-source-app.com/v1/agent/openapi.json"
  }
}

例: メールコードを送る

エージェントがユーザーのメールアドレスを受け取ったら、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.",
  "docs": {
    "openapiUrl": "https://api.flashcards-open-source-app.com/v1/agent/openapi.json"
  }
}

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

例: コードを検証して 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.openapiUrl for the full contract.",
  "docs": {
    "openapiUrl": "https://api.flashcards-open-source-app.com/v1/agent/openapi.json"
  }
}

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

このキーは、すぐにチャット履歴の外へ保存してください。いちばん分かりやすいのは、一度 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.openapiUrl for the full contract.",
  "docs": {
    "openapiUrl": "https://api.flashcards-open-source-app.com/v1/agent/openapi.json"
  }
}

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

  • 利用可能なワークスペースをすべて読み込む
  • まだ存在しなければ最初のワークスペースを作る
  • 複数ある場合は正しいワークスペースを選ぶ
  • /v1/agent/openapi.json で公開されている仕様を確認する
  • POST /v1/agent/sql で読み取り、書き込み、SQL の内省を行う

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

/v1/openapi.json と /v1/swagger.json にあるルート仕様エイリアスも使えますが、エージェント向けのドキュメントリンクは意図的に /v1/agent/openapi.json と /v1/agent/swagger.json を指しています。

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

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

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

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

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

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

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

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

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

試してみる

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

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

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

参考リンク:

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

次に読む

間隔反復に対応したセルフホスト可能なオープンソースのフラッシュカードアプリ

セルフホストできるオープンソースのフラッシュカードアプリを探していますか。高速な復習キュー、パスワードレス認証、学習データを自分で管理できる設計で、間隔反復を快適に使えます。

Anki vs Flashcards Open Source App 2026: 成熟したパワーツールか、現代的なオープンソース学習スタックか

2026年のAnkiとFlashcards Open Source Appを比較します。FSRS、AIカード作成、オフライン対応クライアント、セルフホスティング、移行、そしてAnkiがまだ強い領域を整理します。

Anki vs Quizlet vs オープンソースのフラッシュカードアプリ: 2026年に選ぶならどれか

2026年の Anki、Quizlet、そして現代的なオープンソースのフラッシュカードアプリを比較します。間隔反復の強さ、使い心地、オフライン学習、セルフホスティング、学習データを自分で持ち続けられるかという観点から、実用的な違いを整理しました。

2026年版 コーディング面接向けフラッシュカードの使い方: LeetCodeのパターン、ミス、定着する考え方

2026年にコーディング面接用フラッシュカードを使うなら、LeetCodeのミス、アルゴリズムのパターン、技術面接メモをFSRSの間隔反復に落とし込む実践的な方法が有効です。