[No QA] Docs updates for E/A#91255 document MCP OAuth connections in Device management#92458
[No QA] Docs updates for E/A#91255 document MCP OAuth connections in Device management#92458MelvinBot wants to merge 1 commit into
Conversation
Reflects E/A#91255, which makes the Device management page display MCP OAuth sessions with a friendly label (e.g. "OAuth - MCP (Claude)"). Co-authored-by: Marc Glasser <marcaaron@users.noreply.github.com>
|
A preview of your ExpensifyHelp changes have been deployed to https://c74c6930.helpdot.pages.dev ⚡️ Updated articles: |
Concierge reviewer checklist:
For more detailed instructions on completing this checklist, see How do I review a HelpDot PR as a Concierge Team member? |
|
@truph01 @greg-schroeder One of you needs to copy/paste the Reviewer Checklist from here into a new comment on this PR and complete it. If you have the K2 extension, you can simply click: [this button] |
HelpDot Documentation ReviewOverall AssessmentThis PR adds documentation for MCP OAuth connections appearing in Device management. The change is well-scoped — it adds one explanatory section and two FAQ entries to an existing article, plus expanded keywords. The writing is clear, follows governance conventions closely, and uses verified UI labels. Scores Summary
Key Findings
Recommendations
Files Reviewed
Review based on docs/HELPSITE_NAMING_CONVENTIONS.md, docs/HELP_AUTHORING_GUIDELINES.md, and docs/TEMPLATE.md. |
| title: Manage Logged-in Devices | ||
| description: View signed-in devices and revoke device access for your Expensify account. | ||
| keywords: [manage devices, revoke device access. log out remotely, revoke logged-in device, signed in devices, account security, New Expensify] | ||
| keywords: [manage devices, revoke device access. log out remotely, revoke logged-in device, signed in devices, account security, OAuth connection, MCP connection, AI assistant access, New Expensify] |
There was a problem hiding this comment.
Metadata issue: There is a period instead of a comma in the keywords list — revoke device access. log out remotely should be revoke device access, log out remotely. Since this line was modified in this PR, it is a good opportunity to fix it.
| keywords: [manage devices, revoke device access. log out remotely, revoke logged-in device, signed in devices, account security, OAuth connection, MCP connection, AI assistant access, New Expensify] | |
| keywords: [manage devices, revoke device access, log out remotely, revoke logged-in device, signed in devices, account security, OAuth connection, MCP connection, AI assistant access, New Expensify] |
| The device list shows the device name, operating system or browser, and the last time the device accessed your account. | ||
| The device list shows the device name, operating system or browser, and the last time the device accessed your account. Authorized app connections appear with a label like **OAuth - MCP (Claude)** instead of a device name and operating system. | ||
|
|
||
| ## What does "OAuth - MCP (Claude)" mean in my device list? |
There was a problem hiding this comment.
Naming and style: Per HELPSITE_NAMING_CONVENTIONS.md, UI labels should not be wrapped in quotation marks — use bold formatting instead. Consider rephrasing this FAQ heading to avoid quoting the label, for example:
| ## What does "OAuth - MCP (Claude)" mean in my device list? | |
| ## What the OAuth - MCP (Claude) label means in your device list |
Explanation of Change
This is a help-site (HelpDot) docs update for the changes shipped in #91255.
That PR made the Device management page (Account > Security > Device management) display MCP OAuth sessions with a friendly label like OAuth - MCP (Claude) instead of blank or garbled text, and started showing OAuth (
partnerID86) sessions in the list at all.The existing article
Manage-Logged-in-Devices.mdonly described phone/tablet/browser device entries. This update documents the new entry type so members understand what these connections are and that they can revoke them:## What OAuth and MCP connections appear in Device managementsection explaining that authorized apps (AI assistants connected via the Model Context Protocol — Claude, Cursor, ChatGPT, etc.) appear with a label like OAuth - MCP (Claude), and that clicking Revoke disconnects them.OAuth - MCP (Claude)means.All UI labels were verified against the source: the page title
Device managementandRevokebutton come fromsrc/languages/en.ts, and theOAuth - MCP (<platform>)label text comes verbatim from the mergedgetDeviceDisplayName()helper insrc/libs/UserUtils.ts. TheOAuth - MCP (Claude)label itself could not be visually verified in the live UI because that requires an active MCP OAuth session; it is taken directly from the merged code.The change follows
docs/HELPSITE_NAMING_CONVENTIONS.md,docs/HELP_AUTHORING_GUIDELINES.md, anddocs/TEMPLATE.md(single#title plus# FAQ, task/question-based##headings, exact UI labels).Fixed Issues
$ #92034
Tests
// TODO: The human co-author must fill out the tests you ran before marking this PR as "ready for review"
// Please describe what tests you performed that validates your changed worked.
QA
// TODO: The human co-author must fill out the QA tests you ran before marking this PR as "ready for review".
// Please describe what QA needs to do to validate your changes and what areas do they need to test for regressions.
@marcaaron, please review the files changed and confirm they reflect the current behavior. Then mark this PR
Ready for review.