sqlite-notes
Stytch認証SQLite MCP
SaaSインテグレーションの形を学ぶための、意図的に小さなリモートMCPサービスです:
FastMCPがStreamable HTTP上で6つのツールを提供します。
Stytch Connected AppsがOAuth 2.1ディスカバリ、Dynamic Client Registration、PKCE、 ブラウザログイン、同意、トークン発行を処理します。
このサービスは、StytchのローテーションするJWKSに対して、すべてのアクセストークンの署名、発行者、オーディエンス、有効期限、
openidスコープを検証します。SQLiteの行はトークンの
subをキーとするため、各Stytchユーザーは自分のメモのみを参照できます。アクセスはサーバー側で30分に制限されます。たとえStytchクライアントが誤ってより長いアクセストークンの有効期限で設定されていてもです。
Claude Codeプラグインは固定された
mcp-remoteブリッジを実行し、OAuthを実行してClaude CodeをリモートMCPエンドポイントに接続します。
アーキテクチャ
Claude Code plugin -> http(s)://MCP/mcp -> validate Stytch JWT -> per-user SQLite CRUD
| ^
+-> Stytch discovery -> browser login/consent app -> Stytch token endpointブラウザアプリは必須です。Stytchはディスカバリ、登録、トークンエンドポイントをホストし、アプリケーション側はログインと同意に使用されるIdentityProviderコンポーネントをホストします。
Related MCP server: Notebook MCP Server
1. Stytchを設定する
Consumer Authenticationプロジェクトを作成し、次を設定します:
Frontend SDKで、SDKを有効にし、
http://localhost:3000を許可します。Redirect URLsで、ログインとサインアップの両方に
http://localhost:3000/authenticateを追加します。Email Magic LinksをLogin or Createで有効にします。
Connected Appsで、Authorization URLを
http://localhost:3000/oauth/authorizeに設定します。Dynamic Client Registrationを有効にします。MCPクライアントはコールバックポートが変動しうるためDCRを使用します。
Stytchが許可する場合、Connected Appsのアクセストークンの有効期限を30分に設定します。
サービスとプラグインはopenidのみを要求します。MCPサーバーは安定したsub識別子のみを必要とするためです。プロフィールやメールデータは必要ありません。
サーバーは、各アクセストークンのiatから30分後にそのトークンを拒否します。プラグインは固定されたmcp-remote@0.2.1ブリッジを使用します。このブリッジは、MCP保護リソースがアドバタイズするスコープをoffline_accessを追加せずに要求します。したがってStytchはリフレッシュトークンを発行せず、有効期限が切れるとユーザーは対話型認証に戻されます。
このブリッジは意図的です。ネイティブのClaude Code OAuthは、認可サーバーがoffline_accessをアドバタイズすると自動的にそれを追加し、サイレントなトークン更新を可能にして、強制ログイン要件を無効化します。
.env.exampleを.envにコピーして、次を設定します:
STYTCH_PROJECT_ID:JWTオーディエンスとして使用されるproject-test-...プロジェクトID。STYTCH_DOMAIN:https://...customers.stytch.devなど、Stytchが表示する完全なプロジェクトドメイン。発行者およびJWKSホストとして使用されます。ここにAPIシークレットやパブリックトークンを使用しないでください。STYTCH_PUBLIC_TOKEN:ログインおよび同意UIで使用されるブラウザセーフなpublic-token-test-...値。MCP_BASE_URL:/mcpを含まない、MCPサーバーの外部から見えるオリジン。
このプロジェクトにStytchのシークレットキーは含まれません。JWT検証には公開署名キーのみが必要です。
ダッシュボード設定を保存した後、Stytchのディスカバリと署名キーを検証します:
set -a; source .env; set +a
uv run python scripts/check_stytch.pyPASS: Stytch authorization metadata and JWKS are ready for MCP OAuth.と表示されるまで、ブラウザログインテストに進まないでください。
2. ローカルで実行する
uv sync
set -a; source .env; set +a
uv run mcp-auth別のターミナルで:
cd web
npm install
npm run dev真のOAuthテストのためには、MCPエンドポイントと認可ページの両方が通常、安定したHTTPS URLで到達可能であるべきです。開発用トンネルでポート8000と3000を公開できます。MCP_BASE_URL、Stytch Frontend SDKの許可環境とリダイレクトURL、Connected AppsのAuthorization URL、およびSQLITE_NOTES_MCP_URLをそれらのHTTPS URLに更新します。プレーンなlocalhostセットアップは開発中は有用ですが、本番ではHTTPSを使用する必要があります。
3. Claude Codeプラグインをインストールして認証する
リポジトリのルートから、ローカルマーケットプレイスを登録し、このプロジェクト用のプラグインをインストールします:
claude plugin marketplace add "$PWD" --scope project
claude plugin install sqlite-notes@mcp-auth-local --scope projectローカルサーバーのURLはデフォルトでhttp://127.0.0.1:8000/mcpです。ホスト型またはトンネル型のサーバーの場合は、Claude Codeを起動する前にURLを設定します:
export SQLITE_NOTES_MCP_URL=https://your-mcp-tunnel.example/mcp次に/reload-pluginsを実行し、/mcpを開いてsqlite-notesを選択します。固定されたmcp-remoteブリッジがMCPサーバーを通じてStytch認可サーバーをディスカバリし、自身を登録し、ブラウザを開き、PKCEを使用して、アクセストークンとともに戻ります。
次のようなプロンプトを試してください:
「Grocery listというタイトルで、本文がcoffee and orangesのメモを作成して。」
「私のメモを一覧表示して。」
「メモ1を更新してmilkを追加して。」
「メモ1を削除して。」
30分後、MCPサーバーは現在のアクセストークンを拒否します。ブリッジはoffline_accessを要求しないため、サイレントに更新できず、対話型認証を繰り返す必要があります。
テスト
uv run pytest
cd web && npm run build自動テストはCRUDとユーザー間の分離、および30分のアクセストークン境界をカバーします。設定済みのStytchプロジェクトとメール受信トレイがなければ完全なログインを自動化できないため、ブラウザフローは明示的な手動エンドツーエンドチェックです。
本番環境の注意点
SQLiteと単一プロセスは、この演習では意図的です。有料のマルチインスタンスサービスの場合は、マネージドデータベース、マイグレーション、バックアップ、HTTPS、構造化監査ログ、レート制限、明示的な認可スコープを使用してください。同じ境界を維持してください:Stytchがユーザーを認証し、データベースとサービスがそのユーザーがアクセスできる行とアクションを決定します。
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Google Keep-style notes app with an MCP server for AI agents to read/write notes.
Build, verify and deploy full-stack apps: Postgres, sign-in, workflows, realtime, AI, rollback.
Search and read your own notes: insights, drafts, book and podcast notes. Read-only, OAuth.
Kanban tasks and project notes for AI clients, with OAuth and per-project read or write grants.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenancePersonal note management server that enables creating, reading, updating, deleting, listing, and searching notes with support for titles, content, and tags.-
- FlicenseNot gradedqualityDmaintenanceEnables to create notebooks and notes with tags, and perform full-text search across notes using FTS5 syntax, all stored locally in SQLite.-
- AlicenseNot gradedqualityDmaintenanceA local notes app that enables AI tools to manage notes via MCP (list, get, create, update, delete) using the same SQLite database as the GUI.MIT
- AlicenseAqualityBmaintenanceEnables users to create, retrieve, update, delete, and full-text search a local knowledge base of notes persisted in SQLite with FTS5, exposed over stdio or authenticated Streamable HTTP. It also surfaces recent/single-note resources and prompts for summarizing notes and drafting replies.5MIT