Skip to content

✨ MCP tools permission prompt - Simplify wording to be less verbose and easier to understand #968

Description

@steven0x51

Cc: @calumjs @ricksu978 @adamcogan
Hi

🟥 Watch the video (31 sec)

MCP tools permission prompt is too wordy
Figure: Current in-app prompt asking for permission to use MCP tools/capture a video frame is too verbose and unclear

Pain

During the YakShaver Desktop flow, the app asks for permission to use MCP tools. The current permission prompt copy is too wordy, which makes it harder to understand quickly (especially for non-technical users) and creates friction at a critical step.

Suggested Solution

Rewrite the MCP tools permission prompt into simpler, user-friendly language.

Guidelines for the rewrite:

  • Use plain language.
  • Keep the message short and scannable.
  • Make it clear what YakShaver wants to do and why.
  • Make it clear what happens if the user denies the permission.

Acceptance Criteria

  1. The MCP tools permission prompt copy is rewritten to be shorter and easier to understand.
  2. The prompt explains (in plain language) why YakShaver needs the permission.
  3. The prompt makes clear the impact of denying the permission.
  4. The wording remains consistent with YakShaver’s tone of voice.

Tasks

  • Locate the current MCP tools permission prompt copy in the desktop app codebase.
  • Draft revised prompt copy that is simpler and less technical.
  • Update the UI to use the revised copy.
  • Confirm the new copy fits within the dialog layout without truncation.
  • Validate the wording is understandable for non-technical users.

More Information

Related (similar area): #783 (Improve permission prompt copy)

Screenshots

Thanks!

Metadata

Metadata

Assignees

Labels

Type: FeatureA suggested idea for this projectYakShaverarmada:doneARMADA opened a PR for this issue

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions