SAP Integration Suite Documentation MCP Server

Bring the entire SAP Integration Suite documentation directly into Claude Desktop - search, explore, and get instant answers without leaving your AI assistant.

What is this?

This MCP (Model Context Protocol) server gives Claude Desktop instant access to 3,500+ SAP Integration Suite documentation pages, including:

• 📘 SAP Integration Suite - Complete platform documentation
• 🔌 Cloud Integration - Integration flows, adapters, security
• 🚀 API Management - API proxies, policies, analytics

No more switching between browser tabs. Ask Claude about SAP Integration Suite directly in your conversation.

Quick Start (2 minutes)

Step 1: Install via Claude Desktop Config

Add this to your Claude Desktop configuration:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "sapis-docs": {
      "command": "npx",
      "args": ["@contiva/sapis-docs-mcp"]
    }
  }
}

Step 2: Restart Claude Desktop

That's it! On first launch, the documentation (~50MB) downloads automatically in 1-2 minutes.

Step 3: Start asking questions

Try these in Claude:

"Search for OAuth 2.0 authentication in API Management"

"Show me how to configure CSRF protection in Cloud Integration"

"What are the best practices for error handling in integration flows?"

Why Use This?

✅ Instant, Context-Aware Answers

Instead of searching through help.sap.com manually, Claude can:

• Search across all documentation instantly
• Understand your question contextually
• Combine information from multiple articles
• Give you step-by-step guidance based on official docs

✅ Three Powerful Search Methods

• Full-text search - Find anything in 3,500+ pages
• Title-based search - Fast fuzzy matching for quick lookups
• Semantic search - AI understands what you mean, not just keywords

✅ Works Offline

All documentation and AI embeddings run locally. No API keys needed, no data leaves your machine.

Real-World Examples

Example 1: Learning a New Feature

You:

"I need to set up OAuth 2.0 authentication for my API proxy. Show me the steps."

Claude (with MCP):

I'll search the API Management documentation for OAuth 2.0 setup...

Based on the official documentation, here are the steps to configure OAuth 2.0:

1. Create an OAuth 2.0 Provider in API Management
2. Configure the Token Endpoint... [Complete step-by-step guide with exact configuration]

Example 2: Troubleshooting

You:

"My integration flow is failing with a CSRF token error. How do I fix this?"

Claude (with MCP):

Let me search for CSRF protection documentation in Cloud Integration...

The error occurs because Cloud Integration requires CSRF tokens for state-changing operations. Here's how to configure it:

[Specific troubleshooting steps from the docs]

Example 3: Architecture Decisions

You:

"What's the difference between Basic Authentication and OAuth in SAP Cloud Integration?"

Claude (with MCP):

I'll compare both authentication methods from the documentation...

Basic Authentication:

• Use case: [from docs]
• Security considerations: [from docs]

OAuth 2.0:

• Use case: [from docs]
• Security considerations: [from docs]

Recommendation: [Based on official SAP guidance]

Features in Detail

🎯 AI-Optimized Features (NEW)

This MCP server includes several features specifically designed to improve AI assistant interaction:

• 7 Built-in Prompts - Pre-configured workflows for common tasks (troubleshooting, learning adapters, comparing features, etc.)
• 22 Quick Resources - Direct access to frequently needed documentation without search
• Enhanced Tool Descriptions - Detailed guidance on when and how to use each tool effectively
• Structured Workflows - Best practice patterns for comprehensive documentation exploration

See MCP_IMPROVEMENTS.md for detailed information.

🔍 Smart Search Capabilities

Claude can now:
├─ Search by keywords (full-text)
├─ Search by topic titles (fuzzy matching)
├─ Search by meaning (semantic AI search)
└─ Combine all three for best results

📚 Complete Documentation Coverage

• 1,980 files - Integration Suite main docs
• 1,175 files - Cloud Integration specifics
• 312 files - API Management guides
• Automatically updated from SAP's official repository

⚡ Performance

• Startup: < 1 second
• Search: 100-200ms for full-text, 500ms for semantic
• Memory: ~50-65MB total
• First-time setup: 1-2 minutes (one-time documentation download)

🔒 Privacy-First

• 100% local - All AI embeddings run on your machine
• No API keys - No external services required
• No data sharing - Your queries stay private

Available Commands

Once installed, Claude can use these tools automatically:

🔍 search_documentation

Search across all documentation with combined search methods.

Example questions:

• "Search for SAML authentication"
• "Find documentation about message mapping"
• "Show me API proxy configuration examples"

Search Strategies:

• all (default): Combines fulltext, title, and semantic search
• semantic: Best for conceptual queries ("how to secure APIs")
• fulltext: Best for specific terms or error codes
• title: Best for finding articles by name

📖 read_article

Read complete documentation articles.

Example questions:

• "Read the full article about OAuth configuration"
• "Show me the complete guide for CSRF protection"

Features:

• Accepts file path or LOIO ID
• Automatically resolves links
• Includes metadata and related articles

📑 list_topics

Browse documentation structure hierarchically.

Example questions:

• "List all Cloud Integration topics"
• "Show me the table of contents for API Management"

Areas:

• ISuite: Main Integration Suite documentation
• apim: API Management guides

🔗 get_related_articles

Find related documentation automatically.

Example questions:

• "What else should I read about authentication?"
• "Find related articles to this integration flow guide"

Methods:

• links: Explicit references (fast)
• semantic: Similar content (comprehensive)
• both (default): Combined approach

💡 Built-in Prompts (NEW)

AI assistants can use pre-configured workflows:

• sapis_get_started - Introduction to SAP Integration Suite
• sapis_troubleshoot - Guided troubleshooting with context
• sapis_adapter_guide - Learn about specific adapters
• sapis_api_policy - API Management policy configuration
• sapis_best_practices - Best practices for any topic
• sapis_compare - Compare features or approaches
• sapis_explore_topic - Deep dive into topics

📚 Quick Resources (NEW)

Direct access to 22 frequently needed articles:

Categories:

• Getting Started (3)
• Security (OAuth, SAML, CSRF, Basic Auth)
• Adapters (SOAP, REST, OData, SFTP, Mail)
• Development (Mapping, Scripting, Error Handling)
• Operations (Monitoring, Logging, Analytics)
• Best Practices (Security, Performance, Design)

Usage: readResource("sapis://docs/security/oauth")

Advanced Configuration

Custom Documentation Path

If you cloned the SAP docs repository locally:

{
  "mcpServers": {
    "sapis-docs": {
      "command": "npx",
      "args": ["@contiva/sapis-docs-mcp"],
      "env": {
        "MCP_DOCS_PATH": "/path/to/btp-integration-suite/docs"
      }
    }
  }
}

Cloud Embeddings (Optional)

For faster initial indexing, use cloud-based embeddings:

{
  "mcpServers": {
    "sapis-docs": {
      "command": "npx",
      "args": ["@contiva/sapis-docs-mcp"],
      "env": {
        "EMBEDDING_PROVIDER": "voyage",
        "VOYAGE_API_KEY": "your-api-key"
      }
    }
  }
}

Note: Local embeddings (default) are free and work offline. Cloud embeddings reduce first-time indexing from 10-15 minutes to 2-3 minutes but require an API key.

Troubleshooting

"Documentation not found" error

The first run downloads docs automatically. If it fails:

# Manual installation
git clone https://github.com/SAP-docs/btp-integration-suite.git
export MCP_DOCS_PATH=/path/to/btp-integration-suite/docs

Then restart Claude Desktop.

MCP server not showing up

1. Check your config file path is correct
2. Ensure JSON syntax is valid (use a JSON validator)
3. Restart Claude Desktop completely
4. Check Claude Desktop logs for errors

Slow semantic search

First-time semantic search builds an AI index (10-15 minutes with local embeddings). This is one-time only - subsequent searches are instant.

Development

Local Development Setup

# Clone the MCP server
git clone https://github.com/robertfels/sapis-docs-mcp.git
cd sapis-docs-mcp

# Clone SAP docs (or it downloads automatically)
git clone https://github.com/SAP-docs/btp-integration-suite.git

# Install and build
npm install
npm run build

# Test locally
npm start

Publishing Updates

npm version patch
npm publish --otp=<your-2fa-code>

How It Works

┌─────────────────┐
│  Claude Desktop │
│                 │
│  "Search for    │
│   OAuth in      │
│   API Mgmt"     │
└────────┬────────┘
         │
         │ MCP Protocol
         ▼
┌─────────────────────────────────┐
│  @contiva/sapis-docs-mcp        │
│                                 │
│  ┌───────────┐  ┌────────────┐ │
│  │ Full-text │  │   Title    │ │
│  │  Search   │  │   Search   │ │
│  └───────────┘  └────────────┘ │
│                                 │
│  ┌───────────────────────────┐ │
│  │   Semantic AI Search      │ │
│  │   (Local Embeddings)      │ │
│  └───────────────────────────┘ │
│                                 │
│  ┌───────────────────────────┐ │
│  │  3,500+ Markdown Files    │ │
│  │  (Downloaded from SAP)    │ │
│  └───────────────────────────┘ │
└─────────────────────────────────┘

Related Projects

• Model Context Protocol - Open protocol for AI-tool integration
• SAP Integration Suite Docs - Official SAP documentation repository
• Claude Desktop - AI assistant with MCP support

Contributing to SAP Documentation

Found an error in the SAP documentation? You can contribute!

This MCP server uses the official SAP Integration Suite documentation repository. All contributions to the documentation should be made there.

How to Contribute

1. Open the relevant guide on SAP Help Portal
2. Choose Feedback > Edit page to suggest changes
3. Or choose Feedback > Create issue to report problems

See SAP's Contribution Guidelines for more details.

Covered Documentation Areas

| Guide | Description | |:---|:---| | SAP Integration Suite | Platform overview and general capabilities | | SAP API Management | API proxies, policies, and analytics | | SAP Cloud Integration | Integration flows, adapters, and security |

License

This MCP server is licensed under Apache-2.0.

The SAP documentation content is subject to SAP's licensing terms. See the SAP documentation repository for details.

Support

• Issues: GitHub Issues
• NPM Package: @contiva/sapis-docs-mcp
• SAP Documentation: help.sap.com

Made with ❤️ for the SAP Integration Suite community