Skip to content

docs(cli): explain non-interactive MCP configuration - #57300

Open
Jun516 wants to merge 1 commit into
anomalyco:devfrom
Jun516:noninteractive-mcp-docs
Open

Jun516 wants to merge 1 commit into
anomalyco:devfrom
Jun516:noninteractive-mcp-docs

Conversation

@Jun516

@Jun516 Jun516 commented Oct 20, 2026

Copy link
Copy Markdown

Issue for this PR

Closes #55285

Type of change

  • Bug fix
  • New feature
  • Refactor / code improvement
  • Documentation

What does this PR do?

The English and Simplified Chinese V1 CLI pages only show interactive mcp add. Document the existing non-interactive remote/local forms, repeatable header/environment flags, literal {env:GITHUB_TOKEN} references, and V1's global-config destination.

Earlier attempts (#32283, #32886, #32267) were closed unmerged by automated cleanup/template checks; these additions are still absent. No runtime behavior or V2 documentation changes.

How did you verify your code works?

Checked the flags, global-config write, and variable substitution against v1.19.3 source. New passages pass Prettier 3.6.2; both languages use identical commands, Bash syntax passes, and the links target existing configuration headings.

  • Fork documentation validation: canonical bun run check and packages/web bun run build passed against this exact two-file candidate.
  • Released CLI validation: [email protected] passed both documented commands and repeated-header/environment controls in fresh HOME/XDG directories with stdin closed. Checks assert global V1 mcp[name] configuration, literal header references, values containing =, and command flags after --.

The CLI checks only write configuration; they do not start an MCP server, connect to GitHub, authenticate, or call a model.

AI assistance was used to prepare and check this documentation change.

Screenshots / recordings

N/A — documentation only.

Checklist

  • I have tested my changes locally
  • I have not included unrelated changes in this PR

@github-actions

Copy link
Copy Markdown
Contributor

The following comment was made by an LLM, it may be inaccurate:

@opencode-agent opencode-agent Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks good. I checked every claim against the v1.19.3 source of opencode mcp add and they all hold: a name is required to skip the prompts, you give either --url or a command after --, --header is remote-only and --env local-only, both can be repeated and use KEY=VALUE (split at the first =), header values are stored as typed so {env:GITHUB_TOKEN} stays a literal reference, and adds without prompts go to the global config. Both config links point to existing headings.

Public API impact: none, this is documentation only.

No blocking concerns.

@Jun516

Jun516 commented Oct 21, 2026

Copy link
Copy Markdown
Author

Maintainer CI-approval follow-up for this documentation-only PR, cross-referencing the existing request on #57233:

#57233 (comment)

At the current head f20a3d3, the following upstream workflows are still awaiting authorization:

All three report action_required, not test failures.

The PR standards/compliance checks have passed. Independent fork verification is documented in the PR description, but it does not replace the required upstream checks.

Could a maintainer approve the pending workflow runs, or confirm whether a different verification path is appropriate for this documentation-only change?

Thanks for your time!

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

1 participant