Skip to content

docs: add fx installation guide - #3198

Open
suarezesteban wants to merge 1 commit into
github:mainfrom
suarezesteban:docs-add-fx-install-guide
Open

docs: add fx installation guide#3198
suarezesteban wants to merge 1 commit into
github:mainfrom
suarezesteban:docs-add-fx-install-guide

Conversation

@suarezesteban

Copy link
Copy Markdown

Adds an installation guide for fx, an open source coding agent for the terminal, following the same shape as the OpenCode guide.

  • docs/installation-guides/install-fx.md: new guide covering the remote server with a PAT, toolset filtering, the local Docker server, verification and troubleshooting.
  • docs/installation-guides/README.md: index entry and a row in the support matrix.
  • README.md: a row in both Install in other MCP hosts lists.

One detail worth calling out, since it lines up with the token security guidance in this repo: fx rejects a literal Authorization header in its config so credentials do not become ordinary profile data. The guide uses bearer_token_env instead, which reads the PAT from an environment variable at connection time and never writes it to mcp.json.

Verified against https://api.githubcopilot.com/mcp/ with fx v0.0.7:

github  transport=http  state=ready  protocol=2026-07-28
negotiated_name=github-mcp-server  tools=44  discovery=completed

Toolset filtering was verified too: adding "X-MCP-Toolsets": "repos,issues" under headers brought the catalog from 44 tools down to 28.

The local Docker section follows the pattern in the existing guides and was not run here, since Docker was not available on the machine used for testing.

@suarezesteban
suarezesteban requested a review from a team as a code owner September 1, 2026 12:26
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants