> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apigene.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP Gateway Overview

> Connect AI assistants to Apigene using the Model Context Protocol

## What is the MCP Gateway?

The Apigene MCP Gateway enables AI assistants and chatbots to interact with your Apigene applications through the Model Context Protocol (MCP). Connect tools like Claude Desktop, Cline, or any MCP-compatible client to discover and execute actions across your integrated applications.

## Key Capabilities

### Discover Applications and Actions

* Browse all available applications in your agent
* Search for specific actions by description or type
* Get detailed action schemas and parameters

### Execute Actions

* Run single actions with full parameter control
* Execute the same action multiple times in parallel (batch mode)
* Run different actions simultaneously across multiple apps

### Manage Context (Agent Mode)

* Access agent instructions and capabilities
* List and search available contexts
* Create new contexts to extend agent knowledge

### Skills and optional UI (Agent Mode and deployments with MCP App UI)

* List, read, and create [Agent Skills](https://github.com/agentskills/agentskills) attached to the agent (`list_skills`, `get_skill`, `get_skill_content`, `add_skill`)
* When MCP App UI is enabled: run actions with visual widgets (`run_action_ui`, `run_multi_actions_ui`)

## Two Operation Modes

### MCP Mode

Basic action execution for simple integrations:

* List and search actions
* Execute actions across applications
* Perfect for straightforward API interactions

### Agent Mode

Full agent capabilities with enhanced features:

* Access agent instructions
* Context management
* Application discovery
* Agent Skills (list, fetch content, create)
* Complete agent workflow support

## Getting Started

### Prerequisites

* An Apigene account with configured applications
* An MCP-compatible client (Claude Desktop, Cline, etc.)
* Your application identifier (`genai_app`)

### Connection Steps

1. **Get Your Endpoint**
   * MCP Mode: `https://app.apigene.ai/mcp/{genai_app}/mcp`

   * Agent Mode: `https://app.apigene.ai/agent/{genai_app}/mcp`
   > **Note**: `{genai_app}` is the name of the agent or MCP that is configured in Apigene admin.

2. **Configure Authentication**
   * Use OAuth for user-based access
   * Or use API key for server-to-server access

3. **Connect Your Client**
   * Add the gateway URL to your MCP client configuration
   * Initialize the connection
   * Start using tools and resources

## What You Can Do

### For AI Assistants

Connect your AI assistant to execute real actions across your applications:

* "Send a message in Slack"
* "Create a Jira issue"
* "Get my latest emails from Gmail"

### For Developers

Build integrations that can discover and use Apigene capabilities:

* Dynamic action discovery
* Flexible execution patterns
* Standard MCP protocol compliance

## Next Steps

* [Explore available tools](/user-guide/mcp-gateway/mcp-gateway-tools)
* [Learn about resources](/user-guide/mcp-gateway/mcp-gateway-resources)
* [See usage examples](/user-guide/mcp-gateway/mcp-gateway-examples)