Utilizes certificate-based authentication to securely access SAP systems, handling complex authentication flows for retrieving SAP Notes content.
Provides direct access to SAP Notes and Knowledge Base articles using SAP Passport certificate authentication, enabling searching for specific notes by ID or keywords and retrieving their full content and metadata.
SAP Note Search MCP Server
MCP server for searching SAP Notes/KB articles using SAP Passport authentication and Playwright automation
This Model Context Protocol (MCP) server provides direct access to SAP Notes and Knowledge Base articles through Cursor AI. It uses SAP Passport certificate authentication and Playwright browser automation to retrieve actual note content from SAP's systems.
✨ Features
🔍 Direct SAP Note access - Retrieve full note content and metadata
🎫 SAP Passport authentication - Secure certificate-based authentication
🤖 Playwright automation - Handles complex SAP authentication flows
💾 Smart caching - Authentication tokens cached locally
🔧 Debug-friendly - Comprehensive logging and troubleshooting options
📋 MCP compliant - Works seamlessly with Cursor AI
Live Preview in Cursor
🚀 Quick Start
Prerequisites
Node.js 18+ - Download here
SAP Passport Certificate - Your personal .pfx certificate file
Cursor AI - Download here
Installation
Clone the repository
git clone https://github.com/marianfoo/mcp-sap-notes cd mcp-sap-notesInstall dependencies
npm installBuild the project
npm run build
Setup
Get your SAP Passport certificate - Only possible for S-User
Go to SAP Passport
Create your certificate
Download the .pfx certificate file
Create certificate directory
macOS/Linux:
mkdir certsWindows (PowerShell):
New-Item -ItemType Directory -Force -Path certs | Out-Null
Copy your SAP Passport certificate
Place your
.pfx
certificate file in thecerts/
directoryName it
sap.pfx
(or update the path in configuration)
Configure environment
macOS/Linux:
cp .env.example .envWindows (PowerShell):
Copy-Item .env.example .env
Edit
.env
and add your certificate passphrase:PFX_PATH=./certs/sap.pfx PFX_PASSPHRASE=your_actual_passphrase
Connect to Cursor
Open Cursor settings (
Cmd/Ctrl + ,
)Add MCP server configuration to your
settings.json
:{ "mcpServers": { "sap-note-search": { "command": "node", "args": ["/full/path/to/sap-note-search-mcp/dist/mcp-server.js"] } } }⚠️ Important: Replace the project path with your actual absolute path.
On Windows, use a full path like
C:\\Users\\you\\mcp-sap-notes\\dist\\mcp-server.js
.On macOS/Linux, use a path like
/Users/you/mcp-sap-notes/dist/mcp-server.js
.
Restart Cursor - The SAP Note tools will appear in your AI assistant
🎯 Usage Examples
Search for a specific SAP Note
Search by keywords
Get complete note details
🛠️ Testing & Development
Test Authentication
This tests the SAP Passport authentication flow and verifies your certificate setup.
Test API Access
This tests the SAP Notes API integration and content extraction.
Test Complete MCP Server
This simulates the complete MCP server workflow.
Run All Tests
🐛 Troubleshooting
Certificate Issues
Error: "Certificate file not found"
Ensure the certificate path in your configuration is correct
Use full absolute paths in Cursor's
settings.json
Verify the certificate file exists and is readable
Error: "Authentication failed"
Check your certificate passphrase is correct
Ensure your SAP Passport certificate is valid and not expired
Try running with
HEADFUL=true
to see browser authentication
Browser Issues
Error: "Browser launch failed"
Authentication hangs or times out
Run with debug mode:
HEADFUL=true npm run test:auth
Check your network connection to SAP systems
Verify your certificate has proper SAP system access
MCP Integration Issues
Tools not appearing in Cursor
Restart Cursor completely
Check the MCP server path in
settings.json
is absoluteVerify the
cwd
setting points to your project directory
Error: "MCP server failed to start"
Check the console output in Cursor's developer tools
Ensure all dependencies are installed:
npm install
Verify the build completed successfully:
npm run build
Debug Mode
Enable debug mode for detailed troubleshooting:
📁 Project Structure
⚙️ Configuration
Environment Variables
Variable | Required | Default | Description |
| ✅ | - | Path to SAP Passport certificate (.pfx) |
| ✅ | - | Certificate passphrase |
| ❌ |
| Token cache lifetime (hours) |
| ❌ |
| Browser visibility (for debugging) |
| ❌ |
| Logging level (debug, info, warn, error) |
Playwright Configuration
The server automatically installs required Playwright dependencies. For manual installation:
🔒 Security
Certificate Security: Your SAP Passport certificate never leaves your machine
Token Caching: Authentication tokens are cached locally and expire automatically
No Data Storage: SAP Note content is retrieved on-demand, not stored
Secure Communication: All SAP API calls use HTTPS with certificate authentication
📋 Available Tools
sap_note_search
Search SAP Notes and KB articles by note ID or keywords.
Parameters:
q
(string, required): Query string or Note IDlang
(string, optional): Language code ("EN" or "DE"), defaults to "EN"
sap_note_get
Retrieve full content and metadata for a specific SAP Note.
Parameters:
id
(string, required): SAP Note ID (6-8 digits)lang
(string, optional): Language code ("EN" or "DE"), defaults to "EN"
🤝 Contributing
Fork the repository
Create a feature branch:
git checkout -b feature/amazing-feature
Commit your changes:
git commit -m 'Add amazing feature'
Push to the branch:
git push origin feature/amazing-feature
Open a Pull Request
This server cannot be installed
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
This MCP server allows Cursor AI users to search and retrieve SAP Notes and Knowledge Base articles using SAP Passport authentication and Playwright automation.
Related MCP Servers
- -securityFlicense-qualityThis server acts as a Message Communication Protocol (MCP) service for integrating Apifox and Cursor, enabling OpenAPI interface implementation through AI-driven interaction.Last updated -7
- -securityFlicense-qualityA Cursor MCP server that provides tools and prompts for accessing various Semrush keyword-related API endpoints, enabling keyword research, analysis, and monitoring through natural language.
- -securityAlicense-qualityAn MCP server that provides AI assistants with team analytics capabilities for Cursor editor, allowing them to retrieve team member information, usage metrics, and spending data through natural language queries.Last updated -3MIT License
- -securityAlicense-qualityAn MCP server that provides deep knowledge about OpenAI APIs and SDKs, enabling users to query technical information through various MCP clients including ChatGPT Deep Research, Cursor, and OpenAI Responses API.Last updated -11MIT License