This is an automated email from the ASF dual-hosted git repository.
kparisa pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/iggy-website.git
The following commit(s) were added to refs/heads/main by this push:
new cdbd50d1f docs(ai): explain what the MCP server does on the AI
introduction page (#103)
cdbd50d1f is described below
commit cdbd50d1f6317d8b21addfe2c992a2b4bcd8ef9f
Author: Justin Mclean <[email protected]>
AuthorDate: Wed Sep 16 14:17:09 2026 +1000
docs(ai): explain what the MCP server does on the AI introduction page
(#103)
The AI section introduction was a two-line pointer to the MCP Server
page. It now gives a short, client-agnostic overview drawn from that
page: what an MCP client can do through the server, the HTTP and stdio
transports, and the two layers of access control. It still links to MCP
Server for setup, configuration and the full tool list.
Co-authored-by: Justin Mclean <[email protected]>
Co-authored-by: Kranti Parisa <[email protected]>
---
content/docs/ai/introduction.mdx | 10 +++++++---
1 file changed, 7 insertions(+), 3 deletions(-)
diff --git a/content/docs/ai/introduction.mdx b/content/docs/ai/introduction.mdx
index c6b3243ac..791c8457e 100644
--- a/content/docs/ai/introduction.mdx
+++ b/content/docs/ai/introduction.mdx
@@ -1,8 +1,12 @@
---
title: Introduction
-description: "The AI-related components of Apache Iggy, and where the MCP
server is documented."
+description: "The AI-related components of Apache Iggy: the MCP server that
lets LLM applications work with a running Iggy server."
---
-This module contains the AI-related components of the Apache Iggy message
streaming infrastructure.
+Apache Iggy includes an MCP server, so LLM applications can work with a
running Iggy server. The [Model Context
Protocol](https://modelcontextprotocol.io) (MCP) is an open protocol that
standardizes how applications provide context to LLMs.
-Please check the **[MCP Server](/docs/ai/mcp)** for the details about Iggy MCP
(Model Context Protocol) server.
+Through the MCP server, an MCP client can check server health and statistics,
create and manage streams, topics and partitions, send and poll messages,
manage consumer groups and offsets, and administer users and personal access
tokens. It connects to Iggy over TCP with its own credentials, and supports
**HTTP** (the default) and **stdio** transports, with stdio suited to clients
running on the same machine.
+
+Access is limited in two layers. The `[permissions]` section of the MCP
server's configuration can restrict it to read-only operations, and the Iggy
user it connects as keeps its own permissions on the server. For production
use, connect as a dedicated user with the minimum permissions it needs.
+
+See **[MCP Server](/docs/ai/mcp)** for how to run and configure it, the full
list of tools, and client setup.
