[InlinePizza]

Summary

This PR splits the Claude and ChatGPT page so each reader gets one page that does their job. A Claude user and a ChatGPT user never need each other's setup, and only Owners and reviewers need the server and tool details.

Page	URL	Purpose
Use Promptless from Claude or ChatGPT	/docs/for-docs/work-the-queue/claude-and-chatgpt (unchanged)	Landing page: what you can do from a chat, and which page to go to next
Connect Promptless to Claude	.../claude-and-chatgpt/claude	Takes a Claude user (web or desktop) from no connection to a tested connector
Connect Promptless to ChatGPT	.../claude-and-chatgpt/chatgpt	The same for ChatGPT
Promptless connector reference	.../claude-and-chatgpt/connector-reference	What a connection can access, server details, and the 20 tools

After this merges: update the Claude directory submission to link to .../claude-and-chatgpt/claude.

What changed in the content

• Claude setup now leads with the connectors directory, which listed Promptless on 2026-10-14. It has separate steps for Owners and members and covers the Request button. Adding Promptless as a custom connector is now a short fallback that links to Anthropic's steps.
• Vendor UI is current as of 2026-10-16.
  • Claude tool permissions are now Always allow / Needs approval / Blocked.
  • Claude has separate Disconnect and Remove actions, and a Reconnect button.
  • ChatGPT setup now goes through Plugins > Add custom MCP server. Developer mode stays as a note for accounts with the earlier layout.
• The approval steps use the page's real labels: Returns to, Organization, Your role, and Create organization and authorize as {email}. They match promptless-dashboard/src/app/mcp/authorize.
• The tool table now lists message_promptless_support, so all 20 tools on /mcp/with-direct-edits appear (runtime/mcp/profiles.py). The reference page also gains an "Approval request" row: requests expire after 30 minutes.
• Each setup page has its own approval steps, test prompts, and troubleshooting. That text is written out on both pages rather than imported from one shared file, because the .md copies of pages (which agents read) drop imported MDX. Comments on both pages mark the text that must stay in sync.
• Front matter carries the page brief: purpose, audience, out_of_scope, depends_on_external_ui, and last_verified.

The token lifetimes, approval expiry, membership checks, and tool annotations were checked against runtime origin/main on 2026-10-16.

Needs verification

These are hidden TODO(verify) comments in the pages. The ChatGPT help pages returned 403, so the ChatGPT steps come from search summaries of OpenAI's help article.

• The Claude directory listing uses https://api.gopromptless.ai/mcp/with-direct-edits.
• Directory connectors are available on the Claude Free plan.
• Whether Promptless supports Claude's "Use Claude's published identity" (CIMD). The runtime advertises dynamic client registration only.
• Owners can block individual tools in Organization settings > Connectors.
• The labels in the ChatGPT Plugins steps, and whether the Promptless tab opens at Create as a plugin or at install.
• Whether ChatGPT Plus can add custom MCP servers.
• The ChatGPT reconnect and disconnect labels.

Collateral changes

• astro.config.mjs: the "Work the queue" group is now listed page by page, so the new folder shows as a "Claude & ChatGPT" group (Overview, Claude, ChatGPT, Connector reference). Without this, the group would show the raw folder name.
• connect/triggers/mcp.mdx: updated the link text to the landing page's new title.
• Added OG images and manifest entries for the four pages.
• No redirects, because the existing URL still serves the landing page.

Checks

• Vale, remark-lint, and docmeta pass.
• npm run build passes.
• All links and anchors on the four built pages resolve.
• npm run test:smoke passes 27 of 28. The one failure, agent score landing renders its form…, has been failing since Trim the Agent Score hero and scan progress copy #1159 changed the Agent Score hero copy, so it isn't caused by this PR.

Out of scope, worth fixing

• The MCP triggers page: its Claude section uses /mcp and the old custom-connector steps, and its tool counts are out of date.
• The consent page tells web-app users to "run the connect command in your editor". The new troubleshooting sections tell readers to ignore that wording.
• Open PR docs: Add a dedicated Promptless MCP server page #1109 edits the old intro of this page. It will need a rebase after this merges.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated
promptless-docs	Ready	Preview	Oct 20, 2026 5:47pm UTC

[promptless]

I noticed that some CI checks failed for this PR. I'm investigating whether the failures are caused by this suggestion. If they're unrelated or pre-existing, I'll leave this suggestion unchanged and create a separate suggestion if a standalone docs fix is needed.

[promptless]

Dashboard comment by isaiah@gopromptless.ai:

Closed this suggestion.