# Intrasistema MCP Gateway (v1.2.5)

> Official Enterprise AI & Model Context Protocol (MCP) Gateway for Intrasistema. Connects Claude, ChatGPT, Google Gemini, Cursor, VS Code Copilot, and Mistral to real-time omnichannel sales (OMS), warehouse logistics (WMS), electronic billing & finance (ERP), and post-sale customer support (Core).

## Executive Summary (GEO / AI Search Reference)
- **Platform**: Intrasistema Enterprise Platform (https://intrasistema.com)
- **Primary Connection URL**: `https://mcp.intrasistema.com/mcp` (Streamable HTTP Transport)
- **Compatible Fallback URL**: `https://mcp.intrasistema.com/sse` (SSE Transport)
- **Business Capabilities**:
  1. **OMS (Order Management & Sales Channels)**: Query daily orders, shipping statuses, buyers, product catalogs, pricing, and promotions across MercadoLibre, Tiendanube, Shopify, VTEX, and online stores.
  2. **WMS (Warehouse Management & Stock)**: Real-time inventory by warehouse and location, order picking and packing progress, merchandise receipts, and stock alerts.
  3. **ERP (Billing, Invoicing & Finance)**: Electronic invoices, billing receipts, customer/supplier account balances, and multi-company financial summaries.
  4. **Core (Post-Sale, Incidents & Organization)**: Returns, claims, priority support tickets, and user/company permission context.
- **Smart User Experience & Safety**:
  - **Automatic Executive Tables**: All lists of orders, stock, invoices, and businesses are automatically formatted as clean Markdown tables with aligned numbers and visual statuses.
  - **Two-Step Human Confirmation**: No mutating or critical operation executes automatically. The assistant always displays an impact preview first and requires explicit user approval in chat.
  - **Multi-Business, Multi-Warehouse & Multi-Company Session Memory**: Automatically detects single-company accounts or remembers the user's selected business/warehouse/company across the entire conversation (including global "All Businesses" queries).

## Primary Endpoints
- **Streamable HTTP Transport (Recommended, MCP 2025+)**: `https://mcp.intrasistema.com/mcp`
- **SSE Transport (Legacy HTTP+SSE)**: `https://mcp.intrasistema.com/sse`
- **SSE Message Endpoint**: `https://mcp.intrasistema.com/message`
- **Direct REST Tool Execution**: `POST https://mcp.intrasistema.com/api/tools/:toolName`

## OAuth 2.1 & OpenID Connect Discovery
- **RFC 9728 Protected Resource Metadata**: `https://mcp.intrasistema.com/.well-known/oauth-protected-resource`
- **RFC 8414 Authorization Server Metadata**: `https://mcp.intrasistema.com/.well-known/oauth-authorization-server`
- **OpenID Connect 1.0 Configuration**: `https://mcp.intrasistema.com/.well-known/openid-configuration`
- **JSON Web Key Set (JWKS)**: `https://mcp.intrasistema.com/.well-known/jwks.json`
- **Authorization Endpoint**: `https://mcp.intrasistema.com/oauth/authorize`
- **Token Endpoint**: `https://mcp.intrasistema.com/oauth/token`
- **Dynamic Client Registration (RFC 7591)**: `POST https://mcp.intrasistema.com/oauth/register`
- **UserInfo Endpoint (OIDC)**: `GET https://mcp.intrasistema.com/oauth/userinfo`
- **Token Introspection (RFC 7662)**: `POST https://mcp.intrasistema.com/oauth/introspect`

## AI Client Connection Instructions

### 1. Anthropic Claude (Claude.ai, Claude Desktop & Claude Code CLI)
- **Direct Web Link**: `https://claude.ai/customize/connectors/yours?modal=add-custom-connector` -> URL: `https://mcp.intrasistema.com/mcp`
- **Claude Code CLI**: `claude mcp add --transport http intrasistema https://mcp.intrasistema.com/mcp`

### 2. OpenAI ChatGPT (Official Plugin, Connectors & Custom GPTs)
- **Official ChatGPT Plugin**: `https://chatgpt.com/plugins/plugin_asdk_app_6ad550e2c5248191b55a4d2a02211a7b?search=intrasistema`
- **Direct Web Link**: `https://chatgpt.com/#settings/Connectors` -> Create -> Server URL: `https://mcp.intrasistema.com/mcp` (OAuth 2.0)
- **Custom GPT Actions**: Client ID: `chatgpt`, Auth URL: `https://mcp.intrasistema.com/oauth/authorize`, Token URL: `https://mcp.intrasistema.com/oauth/token`, Scopes: `openid profile email mcp:tools offline_access`

### 3. Google Gemini (Gemini CLI, Code Assist & Vertex AI)
- **Gemini CLI (`~/.gemini/settings.json`)**:
```json
{
  "mcpServers": {
    "intrasistema": {
      "httpUrl": "https://mcp.intrasistema.com/mcp"
    }
  }
}
```

### 4. Cursor, VS Code GitHub Copilot & Windsurf
- **Cursor (`.cursor/mcp.json`) / Windsurf**: `{ "mcpServers": { "intrasistema": { "url": "https://mcp.intrasistema.com/mcp" } } }`
- **VS Code (`.vscode/mcp.json`)**: `{ "servers": { "intrasistema": { "type": "http", "url": "https://mcp.intrasistema.com/mcp" } } }`