encore-go-getting-started

Encore Go のセットアップ

手順

このガイドは Encore Go 向けです。Encore.ts を使う場合は、encore-getting-started を使用してください。ユーザーが希望する言語を伝えていない場合は、確認してください。

手順は順番に進めてください。各手順には、成功したかどうかの確認方法が記載されています。手順に失敗した場合は、指定されたスキルを読み込んでください。

1. CLI を確認する

encore version

• encore version v... と表示される場合： 手順 2 に進みます。
• コマンドが見つからない場合： インストールして（encore-install）、手順 2 に進みます。

2. ログインする

ユーザーがアプリをローカルで実行することだけを希望している場合は、この手順をスキップしてください。

encore auth whoami

• logged in as <email> と表示される場合： 手順 3 に進みます。
• not logged in. と表示される場合： encore auth login をバックグラウンドで起動します。表示されたペアリングコードと URL をユーザーに送り、任意のデバイスのブラウザーで承認するよう依頼してください。Successfully logged in! が表示されるまで待ちます（encore-login）。
• logged in as app <app-id> と表示される場合、またはログインを承認できる人がいない場合（CI）： 認証キーではアプリを作成できません。Cloud Dashboard でアプリを作成するようユーザーに依頼してから、encore app clone <app-id> を実行し、そのディレクトリに cd して、手順 4 に進みます。

3. アプリを作成する

encore app create my-app --example=hello-world
cd my-app

• Successfully created app my-app! で終了する場合： 手順 4 に進みます。
• 空のアプリの場合： サービスのないアプリには、代わりに --example=empty を使用し、手順 4 をスキップします。
• その他のテンプレートやエラーの場合： encore-create-app を参照してください。

4. 実行できることを確認する

encore check 'curl /hello/world'

• "Message": "Hello, world!" と表示され、終了コード 0 で終了する場合： 手順 5 に進みます。
• 失敗する場合： encore-run を参照してください。

ユーザーがアプリを実行し続けられるようにするには、encore run をバックグラウンドで起動してください。フォアグラウンドでは起動しないでください（encore-run）。API は http://localhost:4000、すべてのリクエストのトレースを確認できるローカル開発ダッシュボードは http://localhost:9400 です。

5. Encore の MCP サーバーに接続する

MCP サーバーを使うと、アプリの開発中にアプリを調査して呼び出したり、Encore Cloud へのデプロイ後にその内容を確認したりできます。ユーザーが --llm-rules=<tool> を指定してアプリを作成した場合、そのツール用のローカルサーバーはすでに設定されている可能性があります。重複して追加する前に確認してください。

1. ローカルサーバー： アプリのルートディレクトリで encore mcp start を実行します。MCP stdio Command: encore mcp run --app=<app-id> が表示されます。そのコマンドをユーザーのツールに追加します。Claude Code の場合：

   claude mcp add --transport stdio encore-local -- encore mcp run --app=<app-id>
   

2. Encore Cloud サーバー（手順 2 でログインした場合のみ）：

   claude mcp add --transport http --scope user encore-cloud https://api.encore.dev/mcp
   

3. Cursor、VS Code、その他のツール、またはサインインの代わりに API キーを使う場合： encore-mcp を参照してください。

6. 結果を伝える

セットアップは完了です。次の内容をユーザーに伝えてください。

• アプリの場所： アプリのディレクトリと、Encore Cloud 上にある場合は Cloud Dashboard（https://app.encore.dev/<app-id>）。
• ユーザー側で必要なこと： ツールを再起動すると、新しい MCP サーバーが読み込まれます。encore-cloud を追加した場合は、一度認証する必要もあります。Claude Code では、/mcp を開き、encore-cloud を選択して、Authenticate を選びます。

アプリの開発を進めるには、作業内容に対応するスキルを読み込んでください。hello-world アプリには、hello/ に hello というサービスが 1 つあります。

内容	読み込むスキル
エンドポイント、バリデーション、エラーの追加	encore-go-api
サービスの追加、またはサービス間の呼び出し	encore-go-service
SQL データベースの追加	encore-go-database
エンドポイントでのログイン必須化	encore-go-auth
Pub/Sub、cron ジョブ、バケット、シークレット、キャッシュの追加	encore-go-pubsub、encore-go-cron、encore-go-bucket、encore-go-secret、encore-go-cache
テストの作成	encore-go-testing
デプロイ：コミットしてから git push encore を実行	encore-deploy