Getting Started: SPlus MCP Setup Guide (From Zero to Running)

Who Is This Guide For?

This guide is for complete beginners — you don't need any prior experience with Claude, MCP servers, or Git. By the end of this guide, you'll have an AI assistant that deeply understands the S+ Strategy Management System and can help you navigate planners, generate migration sheets, build strategy models, and more — all through natural conversation.

What you'll set up:

Total setup time: ~10-15 minutes (one-time setup).

Step 1: Install Node.js

Node.js is a runtime that allows the MCP server to run on your machine. You only need to install it once.

On Windows

1. Go to nodejs.org
2. Click the big green "Download Node.js (LTS)" button
3. Run the downloaded .msi installer
4. Click Next through all the prompts (keep all defaults)
5. When the installation finishes, click Finish

On macOS

1. Go to nodejs.org
2. Click "Download Node.js (LTS)"
3. Run the downloaded .pkg installer
4. Follow the installation wizard — click Continue through each step

Verify Installation

Open a terminal (see box below) and type:

node --version

You should see something like v22.x.x or v20.x.x. If you see a version number, Node.js is installed correctly.

How to open a terminal:

• Windows: Press Win + R, type cmd, and press Enter. Or search for "Command Prompt" in the Start menu.
• macOS: Press Cmd + Space, type Terminal, and press Enter.

Step 2: Install Git

Git is a tool that lets you download code repositories from GitHub. You need it to get the MCP server and knowledge base.

On Windows

1. Go to git-scm.com/downloads/win
2. The download should start automatically — run the installer
3. Click Next through all the prompts (the defaults are fine)
4. On the "Adjusting your PATH" screen, keep the recommended option selected
5. Click Install, then Finish

On macOS

Git usually comes pre-installed. To check, open Terminal and type:

git --version

If you see a version number, you're good. If not, macOS will prompt you to install the Command Line Tools — click Install and wait for it to finish.

Verify Installation

git --version

You should see something like git version 2.x.x.

Step 3: Install Claude Code

Claude Code is an AI assistant that runs in your terminal. It's the tool that will use the SPlus MCP server to help you with your work.

On Windows or macOS

1. Open your terminal
2. Run this command:

npm install -g @anthropic-ai/claude-code

3. Wait for the installation to complete (may take a minute)
4. Verify it installed correctly:

claude --version

You should see a version number.

First-Time Login

The first time you use Claude Code, you need to sign in:

1. In your terminal, type:

claude

2. Claude Code will open and prompt you to authenticate
3. It will open your browser to claude.ai — sign in with your Anthropic account (or create one if you don't have one)
4. Once authenticated, your terminal will confirm the connection

Don't have an Anthropic account? Go to claude.ai and click Sign Up. You'll need this to use Claude Code.

Step 4: Download the MCP Server and Knowledge Base

Now you'll download two repositories — the MCP server (the "engine") and the knowledge base (the "brain").

4a: Clone the MCP Server

In your terminal, navigate to a folder where you want to store the files. Your Desktop is fine:

On Windows:

cd %USERPROFILE%\Desktop

On macOS:

cd ~/Desktop

Now clone and build the MCP server:

git clone https://github.com/MasterteamSA/SPlus-Agent.git
cd SPlus-Agent
npm install
npm run build

What each command does:

• git clone — Downloads the MCP server code from GitHub
• cd SPlus-Agent — Enters the downloaded folder
• npm install — Installs the required dependencies
• npm run build — Compiles the server so it's ready to run

Wait for each command to finish before running the next one. If you see no errors, you're good.

4b: Clone the Knowledge Base

Go back to your Desktop and clone the knowledge base:

On Windows:

cd %USERPROFILE%\Desktop

On macOS:

cd ~/Desktop

git clone https://github.com/MasterteamSA/splus-knowledge.git

You should now have two folders on your Desktop:

• SPlus-Agent — The MCP server
• splus-knowledge — The knowledge base

Step 5: Configure Claude Code to Use the MCP Server

This is the step that connects everything together. You need to create a configuration file that tells Claude Code where to find the MCP server and the knowledge base.

Find Your Full Folder Paths

You'll need the full path to both folders. Here's how to find them:

On Windows:

• Open File Explorer and navigate to your Desktop
• Click on the SPlus-Agent folder
• Click the address bar at the top — it will show the full path (e.g., C:\Users\YourName\Desktop\SPlus-Agent)
• Do the same for the splus-knowledge folder

On macOS:

• Open Finder and navigate to your Desktop
• Right-click the SPlus-Agent folder → Get Info
• The "Where" field shows the path. Your full path will be something like /Users/YourName/Desktop/SPlus-Agent

Create the Configuration File

You need to create a file called .mcp.json in your home directory.

On Windows — using Command Prompt:

notepad %USERPROFILE%\.mcp.json

When Notepad opens (it may ask if you want to create a new file — click Yes), paste the following and replace the paths with your actual paths:

{
  "mcpServers": {
    "splus-knowledge": {
      "command": "node",
      "args": ["C:\\Users\\YourName\\Desktop\\SPlus-Agent\\dist\\index.js"],
      "env": {
        "SPLUS_KNOWLEDGE_PATH": "C:\\Users\\YourName\\Desktop\\splus-knowledge\\knowledge"
      }
    }
  }
}

Save and close Notepad (Ctrl + S, then close).

On macOS — using Terminal:

nano ~/.mcp.json

Paste the following and replace the paths with your actual paths:

{
  "mcpServers": {
    "splus-knowledge": {
      "command": "node",
      "args": ["/Users/YourName/Desktop/SPlus-Agent/dist/index.js"],
      "env": {
        "SPLUS_KNOWLEDGE_PATH": "/Users/YourName/Desktop/splus-knowledge/knowledge"
      }
    }
  }
}

Save and exit (Ctrl + O, press Enter, then Ctrl + X).

Important: Replace YourName with your actual computer username in all paths. The paths must match exactly where you cloned the repositories.

Already have a PPlus MCP configured?

If you already set up the PPlus MCP and have an existing .mcp.json, don't overwrite it — add the SPlus server alongside the existing one:

{
  "mcpServers": {
    "pplus-knowledge": {
      "command": "node",
      "args": ["/Users/YourName/Desktop/PPlus-Agent/dist/index.js"],
      "env": {
        "PPLUS_KNOWLEDGE_PATH": "/Users/YourName/Desktop/pplus-knowledge/knowledge"
      }
    },
    "splus-knowledge": {
      "command": "node",
      "args": ["/Users/YourName/Desktop/SPlus-Agent/dist/index.js"],
      "env": {
        "SPLUS_KNOWLEDGE_PATH": "/Users/YourName/Desktop/splus-knowledge/knowledge"
      }
    }
  }
}

This gives Claude both PPlus and SPlus knowledge simultaneously.

Step 6: Restart Claude Code and Verify

Close your terminal completely and open a new one. Then start Claude Code:

claude

When Claude Code starts, it will automatically detect and connect to the splus-knowledge MCP server. You should see the MCP tools become available.

Test It Out

Try these commands to confirm everything is working:

You: List all available SPlus knowledge chunks

Claude: [Uses list_chunks tool]
→ Returns all available chunks across knowledge categories

You: What component types exist in the S+ strategy model?

Claude: [Uses search_knowledge tool]
→ Returns Objectives, Initiatives, KPIs, Focus Areas, and other strategy components

You: How do I create a migration sheet for an S+ instance?

Claude: [Uses get_migration_guide tool]
→ Returns the complete step-by-step migration sheet generation process

If Claude responds with structured S+ knowledge, your setup is complete.

What Can You Do Now?

With the MCP server running, Claude Code has specialized S+ tools at its disposal:

Example: Generate a Migration Sheet

Once the MCP is set up, generating a migration sheet is as simple as telling Claude what you need:

Navigate the following S+ Strategy Management instance and create a
migration Excel workbook for all component types.

Strategy Builder URL: [https://clientname.masterteam.sa/template/14]
Planner URL: [https://clientname.masterteam.sa/planner/12]

Use the splus-knowledge MCP tools to guide the extraction and ensure
all creation form fields are captured accurately.

Claude will automatically use the right tools to inspect each component type's creation form, capture all fields, identify parent-child relationships, and generate a ready-to-use Excel workbook — with quarterly target columns for 3 years and sample data.

For the full migration guide, check out the S+ Migration Sheet Generation post.

Troubleshooting

"node: command not found"

Node.js is not installed or not in your PATH. Re-install Node.js from nodejs.org and make sure to restart your terminal after installation.

"git: command not found"

Git is not installed. Follow the Git installation steps in Step 2.

"npm: command not found"

npm comes bundled with Node.js. If this happens, re-install Node.js.

"claude: command not found"

Claude Code is not installed globally. Run npm install -g @anthropic-ai/claude-code again. If you get a permission error on macOS, prefix with sudo:

sudo npm install -g @anthropic-ai/claude-code

MCP server not connecting

1. Make sure you ran npm run build inside the SPlus-Agent folder
2. Double-check the paths in ~/.mcp.json — they must be exact, with no typos
3. On Windows, use double backslashes (\\) in paths
4. Restart Claude Code completely (close terminal and reopen)

"SPLUS_KNOWLEDGE_PATH" errors

The path to the knowledge base is incorrect. Make sure the path in .mcp.json points to the knowledge folder inside the splus-knowledge repository, not the repository root itself.

Correct:   .../splus-knowledge/knowledge
Incorrect: .../splus-knowledge

Conflict with PPlus MCP config

If you see an error about duplicate server names, make sure each server in .mcp.json has a unique key (pplus-knowledge vs splus-knowledge). Both can coexist in the same file — see the "Already have a PPlus MCP configured?" section above.

Still stuck?

Open Claude Code and ask it directly — it can help debug MCP connection issues:

You: My splus-knowledge MCP server isn't connecting. Can you help me debug?

Quick Reference Card

Here's a summary you can come back to:

Next Steps

• S+ Migration Sheet Generation — Extract all component types from a live S+ instance into a ready-to-use Excel workbook
• S+ User Manual Generation — Automatically generate bilingual user manuals for any S+ deployment
• Getting Started: PPlus MCP — Set up the PPlus Knowledge MCP alongside this one
• SPlus Knowledge Base on GitHub — Explore the knowledge chunks directly
• MCP Server on GitHub — View the server source code and contribute