Skip to content

docs: add Model Context Protocol (MCP) add-on page (EN + DE)#781

Merged
MichaelOv merged 2 commits into
mainfrom
docs/mcp-add-on
Jul 6, 2026
Merged

docs: add Model Context Protocol (MCP) add-on page (EN + DE)#781
MichaelOv merged 2 commits into
mainfrom
docs/mcp-add-on

Conversation

@MichaelOv

Copy link
Copy Markdown
Contributor

Summary

Adds a customer-facing documentation page for the i-doit up MCP add-on (released as v1.0.0) under Admin guide → Integrations, in English and German.

Scope is the in-product "connect & use" experience:

  • What the MCP add-on does: read, and gated write, of CMDB data over the Model Context Protocol.
  • Where to find it: Settings → MCP with the How to connect and Logs tabs.
  • Creating an app token: Settings → Users → open user → Apps.
  • Connecting an AI client via the How to connect wizard: the two available methods (Authorization header over Streamable HTTP, recommended; legacy SSE), both header-based.
  • Read vs write access: write is enabled by default; keep a client read-only by giving its token a user without write rights.
  • The access log (Logs tab), including how to grant the MCP Logs access right.

Changes

  • docs/{en,de}/admin/mcp.md (new)
  • docs/{en,de}/img/admin/mcp-how-to-connect.png, mcp-access-log.png (new, 1920x1080)
  • Nav entry under Integrations in i18n/{en,de}/mkdocs.yml

Notes

  • Deployment/hosting of the MCP service is intentionally out of scope (in-product usage only).
  • Both mkdocs builds (en, de) pass with no new warnings.

Customer-facing page under Admin guide -> Integrations covering:
what the MCP add-on does, where to find it (Settings -> MCP), creating
an app token, connecting an AI client (Streamable HTTP and legacy SSE,
both header-based), read vs write access, and the access log.

Adds nav entries to i18n/en and i18n/de and two 1920x1080 screenshots.
@MichaelOv MichaelOv requested a review from a team as a code owner July 6, 2026 13:21
@MichaelOv MichaelOv requested review from MartinHartkopf and ljuergenliemke and removed request for a team July 6, 2026 13:34
@MichaelOv MichaelOv self-assigned this Jul 6, 2026
- Indent fenced code blocks and list continuations to 4 spaces
  (editorconfig-checker requires multiples of 4).
- Add MCP, mcp, Streamable / claude to the en and de cspell wordlists.
@MichaelOv MichaelOv merged commit 315fc89 into main Jul 6, 2026
12 checks passed
@MichaelOv MichaelOv deleted the docs/mcp-add-on branch July 6, 2026 14:42
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