
toneの技術スタックについて
目次
こんにちは、開発チームの大西です。人とAIのためのタスク管理サービス「tone」の、いまの技術スタックを紹介します。
以前、Zennに技術スタックの記事を書いたことがあります。その後、MCPサーバーの置き方やメール送信の仕組みなどが変わったので、公式ブログ向けに書き直しました。セキュリティ機能については別の記事で紹介します。
全体の構成
いまの構成は、ざっくり次のとおりです。ドメインとWAFはCloudflareで管理しています。

利用者とAIクライアントから、Cloudflare、フロントエンド、API・MCP、外部サービスまでの流れ
- ドメイン・WAF: Cloudflare
- フロントエンド: Next.js 15(Pages Router)とReact 19
- APIとMCPサーバー: GoとConnect RPC。Google Cloud Runの同じプロセスで動かしています
- 認証・認可: 認証はFirebase Authentication、認可はCasbin
- 決済: Stripe(CheckoutとWebhook)
- リアルタイム: Supabase Realtime。タスク一覧で、誰がどのタスクを見ているか、どれが更新されたかを表示するために使っています
- メール・通知: Amazon SES、Slack、Web Push
- ストレージ・外部連携: Cloudflare R2(画像のアップロード)、GitHub App
- 監視: Sentry、Cloud Logging、Cloud Trace(OpenTelemetry)
ランディングページとブログは、同じモノレポのなかの別アプリです。ブログの本文はmicroCMSで管理し、表示はNext.jsで行っています。
バックエンド
インフラ
Web API、MCP、StripeやSlack、GitHubからのWebhook、定期実行など、サービス側の処理はGoogle Cloud Runに集約しています。リクエストに応じて起動する課金で、待ちのインスタンスは0にしています。
以前はAPIとMCPを別の基盤に置いていましたが、いまは同じCloud Runサービス、同じオリジンで配信しています。Connect APIもRemote MCPも、同じプロセスから提供する形です。
決済にはStripeのCheckoutを使い、決済完了などの通知はWebhookでCloud Runが受け取っています。タスク一覧のリアルタイムな更新にはSupabase Realtimeを使っており、誰がどのタスクを見ているか、どれが更新されたかを画面に反映しています。
メールの送信には、以前はResendを使っていましたが、料金の面からAmazon SESに切り替えました。Resendのほうがディベロッパーフレンドリーではありますが、AIを使って開発しているので、多少コードが煩雑になっても問題ないと考えています。
Goとコードの書き方
バックエンドの言語はGoです。静的型付けであること、動作が速いこと、文法がシンプルで、人もAIも読みやすいコードになりやすいことが採用の理由です。
コードの役割は、おおまかに次のように分けています。
- controller: エンドポイントの定義。リクエストから必要な情報を取り、usecaseを呼び出し、結果をAPIの形に変換します
- usecase: ビジネスロジックやデータベースへの問い合わせ、外部APIの呼び出しを記述します。自動テストの多くが実際のデータベースに近い環境と通信するため、repository層はあえて置いていません
- entity: テーブル定義や、プロジェクト全体で使う重要なオブジェクト
usecaseの関数はトップレベル関数として書いており、必要ならusecase同士で呼び出すこともよしとしています。厳密に層を分けるより、共通化やリファクタリングがしやすいと考えているためです。
GORMとGORM Gen
ORMはGORMを使っています。GORM単体だと型の恩恵を受けにくいので、拡張のGORM Genも採用しています。テーブル定義から型付きのクエリが生成されるので、人もAIも間違えにくくなります。
データの取得では、ワークスペースの境界を必ず条件に含めるようにしています。IDだけを見てから権限を判定する、という書き方は避ける方針です。
認可
認可にはCasbinを使っています。toneでは、権限・ロール・ユーザーグループを使ったRBACを提供しています。たとえば、請求まわりだけを扱えるユーザーを作る、といったことができます。
認可はビジネスのルールも複雑になりやすく、データベースへの問い合わせも多くなります。コードだけで頑張るとすぐに破綻しそうだったので、Casbinに寄せました。学習コストはありますが、「誰が」「どのリソースに対して」「何ができるか」という形で一貫して書けるようになり、プライベートリストのような閲覧制限にも同じ考え方を使えています。
Connect RPC
APIのスキーマはProtocol Buffersで定義し、BufでGoとTypeScriptのコードを生成しています。通信ライブラリはConnect RPCです。ブラウザから使うときにプロキシサーバーを別途用意しなくてもよく、スキーマを共有したまま型安全に開発できます。
Connectで作ったAPIは、gRPCとしてもHTTPとしても呼び出せます。変更の多いWebフロントエンドからは型安全にConnectで呼び、MCPサーバー側からはHTTPで呼ぶ、といった使い分けができます。
少人数で、しかもAIと一緒に開発しているので、スキーマを先に決めることでコミュニケーションのコストが下がったと感じています。
自動テスト
純粋なビジネスロジックは、データベースを使わないスモールテストで確認しています。エンドポイント全体の振る舞い、たとえばデータベースが正しく更新されるかといった副作用も含めた確認は、ミディアムテストで実装しています。
ミディアムテストはTestcontainersを使い、毎回本物のMySQLを新しい環境として起動して実行しています。常設のテスト用データベースを持たないので、運用コストもかかりません。
目的は、ほとんどがデグレの防止です。エンドポイントごとに応答を確認し、更新したあとに別のAPIの結果も正しく変わるかを見るテストを、たくさん書く方針にしています。
MCPサーバー
toneのRemote MCPは、APIと同じプロセスで提供しています。ChatGPT、Claude、Cursor、Grok Botなどから、OAuthでtoneのワークスペースにつなげます。
認証はOAuthのAuthorization CodeとPKCE、Dynamic Client Registrationに対応しています。つなぐときはtoneの同意画面が開き、対象のワークスペースと権限を確認してから許可します。権限は次の3つです。
- 読み取り(必須)
- タスクの作成・更新
- リストの作成
書き込み権限は、必要なものだけ付けられます。選んだ権限があっても、tone上でその人に許されていない操作はできません。MCPへのリクエストにはレート制限もかけています。
フロントエンド
フロントエンドの主な技術は次のとおりです。
- Next.js 15(Pages Router)、React 19、TypeScript
- Connect Query: APIとの通信とキャッシュ。画面を軽く感じられるよう、楽観的な更新もしています
- TanStack Table: タスク一覧
- Supabase Realtime: 誰がどのタスクを閲覧・編集中かをリアルタイムに表示
- React Flow: オートメーションのGUI
- TipTap 3: タスクの説明などのリッチテキスト
- Mantine UI v9とTailwind CSS: UIはMantineを主軸に、細かい調整をTailwindで行います
- Firebase Authentication: ログインとルートの保護
- Vitest: コンポーネントやロジックのテスト
- i18n: 日本語と英語
開発の進め方
フロントエンド、バックエンド、ランディングページ、ブログ、AI連携用のパッケージは、1つのモノレポで管理しています。AIに実装を頼むときも、関連するコードを同じ場所で参照できる方が都合がよいと考えています。
開発ツールとよく使うコマンドは、miseで揃えています。以前はDev Containerで環境を共通化していましたが、CursorやCodexのデスクトップアプリとの相性を考えてやめ、miseに一本化しました。環境を揃えるという意味では、miseでも実現できています。AIエージェントがコンテナに閉じないというリスクはありますが、現時点では許容しています。スキーマはprotobufで一元的に定義しているので、フロントエンドとバックエンドで型がずれにくい状態を保てます。
CIのコストが増え続けていたこともあり、考え方を変えました。いまはGitのpre-pushフックで、変更した領域のlintとテストをローカルで実行しています。AIも賢くなり、これでほとんど問題はないと捉えていて、実際にも問題にはなっていません。GitHub ActionsはCDに使っています。
「実装して、テストを回して、直す」のサイクルをAIも回しやすいよう、テストのコマンドや方針もリポジトリに書いています。Goの書き方がシンプルなこと、認可のパターンがCasbinに寄っていること、usecaseを素朴に書けてテストで確かめられることも、その助けになっていると思います。
おわりに
toneのいまの技術スタックを紹介しました。人とAIが同じ場で仕事を進められるよう、これからも技術の選択を丁寧に進めていきたいと思っています。
技術的な話も含め、toneでのタスク管理、ぜひ使ってみてください!


