AJAX-197: Document OAuth redirect URL setup

.agents/INSTRUCTIONS.alpha.md

@@ -45,6 +45,7 @@ worker.oauth("googleAuth", { name: "my-google-auth", provider: "google" });
 - All `execute` handlers receive a Notion SDK client in the second argument as `context.notion`.
 
 - For user-managed OAuth, supply `name`, `authorizationEndpoint`, `tokenEndpoint`, `clientId`, `clientSecret`, and `scope` (optional: `authorizationParams`, `callbackUrl`, `accessTokenExpireMs`).
+- After deploying a worker with an OAuth capability, the user must configure their OAuth provider's redirect URL to match the one assigned by Notion. Run `ntn workers oauth show-redirect-url` to get the redirect URL, then set it in the provider's OAuth app settings. **Always remind the user of this step after deploying any OAuth capability.**
 
 ### Sync
 #### Strategy and Pagination

.agents/INSTRUCTIONS.md

@@ -47,6 +47,8 @@ const myOAuth = worker.oauth("myOAuth", {
 
 The OAuth capability allows you to perform the three legged OAuth flow after specifying parameters of your OAuth client: `name`, `authorizationEndpoint`, `tokenEndpoint`, `clientId`, `clientSecret`, and `scope` (optional: `authorizationParams`, `callbackUrl`, `accessTokenExpireMs`).
 
+After deploying a worker with an OAuth capability, the user must configure their OAuth provider's redirect URL to match the one assigned by Notion. Run `ntn workers oauth show-redirect-url` to get the redirect URL, then set it in the provider's OAuth app settings. **Always remind the user of this step after deploying any OAuth capability.**
+
 ### Other capabilities
 
 There are additional capability types in the SDK but these are restricted to a private alpha. Only Agent tools and OAuth are generally available.

README.md

@@ -100,7 +100,13 @@ worker.oauth("githubAuth", {
 });
 ```
 
-Start the OAuth flow:
+After deploying, get your redirect URL and add it to your OAuth provider's app settings:
+
+```shell
+ntn workers oauth show-redirect-url
+```
+
+Then start the OAuth flow:
 
 ```shell
 ntn workers oauth start githubAuth
@@ -291,6 +297,9 @@ ntn workers runs logs <runId>
 # Start OAuth flow
 ntn workers oauth start <oauthName>
 
+# Show OAuth redirect URL (set this in your provider's app settings)
+ntn workers oauth show-redirect-url
+
 # Display help for all commands
 ntn --help
 ```