Wiki source code of Configure the MCP Server
Last modified by superadmin on 2026/10/14 18:44
Show last authors
| author | version | line-number | content |
|---|---|---|---|
| 1 | Set up this wiki's MCP endpoint and choose what it exposes. Read [[MCP User Permissions>>doc:documentation.extensions.admin.llm.mcp-server.user-permissions.WebHome]] first: everything an agent can reach is bounded by the wiki user it connects as. | ||
| 2 | |||
| 3 | 1. Open the wiki's administration and go to "Other > MCP Server".((( | ||
| 4 | {{image reference="mcp-admin-section.png" size="extra" alt="The wiki administration, with the MCP Server entry of the Other category highlighted in the left navigation and the MCP Server section open beside it"/}} | ||
| 5 | ))) | ||
| 6 | 1. Check that the MCP server is enabled. It is enabled by default; a subwiki has its own toggle, while the main wiki's is controlled from the farm dashboard. | ||
| 7 | 1. Set the server name advertised to connecting agents. It defaults to the wiki's pretty name.((( | ||
| 8 | {{image reference="mcp-server-name.png" size="large" alt="The Server Name field of the MCP Server administration section, highlighted and filled in with Product Wiki"/}} | ||
| 9 | ))) | ||
| 10 | 1. Set the server description, which is sent to agents as the MCP initialization instructions. A "call man first" hint is appended automatically. | ||
| 11 | 1. Select the tools this wiki exposes in the tool tree. Every non-write tool is selected by default; see [[Tool Policies>>doc:documentation.extensions.admin.llm.mcp-server.tool-policies.WebHome]].((( | ||
| 12 | {{image reference="mcp-tool-tree.png" size="large" alt="The tool tree of the MCP Server administration section, with the Search and Navigation group highlighted and all six of its tools ticked"/}} | ||
| 13 | ))) | ||
| 14 | 1. Optionally [[enable write tools>>doc:documentation.extensions.admin.llm.mcp-server.enable-write-tools.WebHome]], which are all off by default. | ||
| 15 | 1. Decide whether the endpoint may return rendered content. "Allow Rendered Content" is on by default and lets ##get_document## return HTML-rendered content, which executes the page's macros with the page author's rights, exactly as viewing the page does. Turn it off to restrict agents to raw wiki source. | ||
| 16 | 1. Save the configuration. The next request rebuilds the server with the new settings, with no restart. | ||
| 17 | 1. Check from an MCP client that the endpoint reports as connected. With OpenCode, ##opencode mcp list## names the server and the URL it answered on.((( | ||
| 18 | {{image reference="mcp-server-connected.png" size="extra" alt="Output of the opencode mcp list command in a terminal, with the line reading xwiki connected and the endpoint URL below it highlighted"/}} | ||
| 19 | ))) |
