Skip to content

Commit cdb9708

Browse files
committed
docs: add MCP bearer token authentication guidance
1 parent 6cefd42 commit cdb9708

2 files changed

Lines changed: 11 additions & 2 deletions

File tree

src/docs/ai/ai-integration-troubleshooting.md

Lines changed: 5 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -36,8 +36,11 @@ If another local AI app cannot use Freeplane through MCP:
3636
- enable `AI MCP server enabled`,
3737
- check `AI MCP server port`,
3838
- check `MCP token`,
39-
- ensure your client sends the token in header
40-
`X-Freeplane-MCP-Token`.
39+
- ensure your client sends the token using one supported header:
40+
`Authorization: Bearer <MCP token>` (preferred) or
41+
`X-Freeplane-MCP-Token: <MCP token>` (legacy).
42+
- if your client sends both headers, ensure both token values are
43+
identical.
4144

4245
If port is in use, choose another port and restart the server.
4346

src/docs/ai/model-context-protocol-server.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -30,6 +30,12 @@ Open AI Preferences (from the AI panel burger menu), then use:
3030
3. Set or regenerate `MCP token`.
3131
4. In your local AI app (for example Claude Desktop or Codex App),
3232
connect to the Freeplane MCP server using that port and token.
33+
Supported authentication headers are:
34+
- `Authorization: Bearer <MCP token>` (preferred)
35+
- `X-Freeplane-MCP-Token: <MCP token>` (legacy, still supported)
36+
37+
If your client sends both headers, they must contain the same token
38+
value.
3339

3440
If `MCP token` is empty, Freeplane generates a new token on the first
3541
incoming client request. That first request is rejected by design. Copy

0 commit comments

Comments
 (0)