Skip to content

Chat setup: clickable link to create the provider app, callback URL as a copyable block - #948

Merged
keysersoft merged 2 commits into
mainfrom
keysersoft/chat-setup-app-link
Oct 8, 2026
Merged

keysersoft merged 2 commits into
mainfrom
keysersoft/chat-setup-app-link

Conversation

@keysersoft

@keysersoft keysersoft commented Oct 8, 2026 •

Copy link
Copy Markdown
Contributor

Matteo's screenshot (Claude on a phone, Etsy setup from the chat): Claude wrote "etsy.com/developers → Your apps" as plain text and the callback URL inline in the sentence, so it could not be tapped or copied in one go.

  • New optional adapter field appRegistrationUrl: the provider page where the user creates the app. It is validated as https in validate-adapters. Etsy: https://www.etsy.com/developers/register.
  • setup_find_connectors and setup_install_connector now return createTheAppAt for adapters that sign in through the user's own app. The value is that field, or else the first help link of the adapter's settings. Both tools also return showToTheUser: give the link as a clickable Markdown link with the full address, and the callback URL alone in a fenced code block. callbackUrlToRegisterInTheProviderApp is unchanged.
  • Etsy's prerequisites on the setup page link the Create-app page as Markdown.

Tests: setup spec extended (Etsy gets the link and the instruction, OpenPLZ gets neither). Full backend jest passes (9991), and backend and frontend tsc are clean.

Second commit

  • Bridges that register their OAuth client themselves (Notion, Helium 10) no longer get a callback URL or "create an app": their setup line says "No app to create". Before, they would have received the callback instruction too.
  • appRegistrationUrl for 15 more connectors, each from the vendor's own docs: Box, Dropbox, Fatture in Cloud, Fortnox (developer programme start page), FreshBooks, Google Analytics 4 / Google Ads / Search Console (console.cloud.google.com/auth/clients), Revolut Business, Teamleader, Visma eAccounting, Zoho CRM, Sage Business Cloud (developer self-service), LinkedIn Ads, DATEV sandbox.
  • Left on their existing help link, because no stable create page exists: Exact Online (country-specific App Center), Reddit Ads (link carries a business id), Sage 200 (credentials by request form), Worksection (inside each account), Mercado Libre (one DevCenter per country), Microsoft Entra (app list with "New registration"). Nimble issues credentials by email.

@keysersoft
keysersoft requested a review from D3nisty as a code owner October 8, 2026 06:42
@keysersoft
keysersoft force-pushed the keysersoft/chat-setup-app-link branch from b87b521 to e53bf5c Compare October 8, 2026 07:02
…n a copyable block

When a connector signs in through the user's own app (Etsy, Google, ...),
setup_find_connectors and setup_install_connector now return where to create
that app (new adapter field appRegistrationUrl, else the first help link of its
settings) and tell the model to show it as a clickable Markdown link and the
callback URL alone in a fenced code block. Claude paraphrased both as plain
text before, which a user on a phone could neither tap nor copy. Etsy links its
Create a New App page, also from its prerequisites.
…ient; create-app links for 15 more connectors

Notion and Helium 10 register their OAuth client themselves, so they no longer
get a callback URL to register or an app to create. Box, Dropbox, Fatture in
Cloud, Fortnox, FreshBooks, the three Google connectors, Revolut Business,
Teamleader, Visma eAccounting, Zoho CRM, Sage Business Cloud, LinkedIn Ads and
the DATEV sandbox get appRegistrationUrl, each taken from the vendor's own docs.
@keysersoft
keysersoft force-pushed the keysersoft/chat-setup-app-link branch from e53bf5c to ad74743 Compare October 8, 2026 12:35
@keysersoft
keysersoft merged commit b193a62 into main Oct 8, 2026
1 check passed
@keysersoft
keysersoft deleted the keysersoft/chat-setup-app-link branch October 8, 2026 12:35
@github-actions github-actions Bot locked and limited conversation to collaborators Oct 8, 2026
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant