🛠️
チーム運営

toneの技術スタックについて

記事をシェア
目次

こんにちは、開発チームの大西です。人とAIのためのタスク管理サービス「tone」の、いまの技術スタックを紹介します。

以前、Zennに技術スタックの記事を書いたことがあります。その後、MCPサーバーの置き方やメール送信の仕組みなどが変わったので、公式ブログ向けに書き直しました。セキュリティ機能については別の記事で紹介します。

全体の構成

いまの構成は、ざっくり次のとおりです。ドメインとWAFはCloudflareで管理しています。

toneの全体構成図
利用者と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でのタスク管理、ぜひ使ってみてください!

関連記事