Skip to main content

Claude Desktop

Learn how to connect SQAI Suite to the Claude Desktop application using the Model Context Protocol (MCP). This guide covers the configuration steps for both Windows and macOS to enable Claude to interact with your software's lifecycle and testing data.

Updated yesterday

The SQAI Suite MCP (Model Context Protocol) server acts as a centralized intelligence layer for your development environment. It connects your code, user stories, and test management tools into a single, real-time understanding of the system under development.

Added Value: A Context-Aware Bridge

By connecting the SQAI MCP to Claude Desktop, you create a direct link between Claude's reasoning capabilities and your broader project data:

  • Unified Intelligence: It connects code repositories, user stories, and documentation so Claude understands the relationship between different artifacts.

  • Automated Traceability: Easily perform tasks like automated test generation, impact analysis, or documentation creation directly within your chat session.

  • Continuous Updates: As you change your code or update a user story, the MCP enables you to keep the system model updated, ensuring Claude is never working with stale information.

1. Generate Your API Key

You need an authentication key to securely connect Claude Desktop to the SQAI Platform.

  1. Log in to the SQAI Platform.

  2. Go to the MCP Configuration page: app.sqai-suite.com/mcp.

  3. Generate and copy your unique API Key.

2. Setup Instructions

Claude Desktop is configured via a global claude_desktop_config.json file.

2.1 Locate the Configuration File

You can open the configuration file directly through the Claude Desktop app or navigate to it manually.

  • Via the App:

    • Windows: Click the hamburger menu (≑) > File > Settings > Developer > Edit Config.

    • macOS: Click Claude in the menu bar > Settings > Developer > Edit Config.

  • Manual Path:

    • Windows: %APPDATA%\Claude\claude_desktop_config.json

    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

2.2 Configuration Snippet

Paste the following into the mcpServers object in your configuration file. Replace your-SQAI-access-token with the API key you generated in Step 1.

JSON

{
"mcpServers": {
"SQAI-Suite": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://api.sqai-suite.com/mcp",
"--header",
"Authorization:your-SQAI-access-token"
]
}
}
}

3. How to Use

  1. Restart Claude Desktop: After saving the JSON file, you must fully quit and restart the Claude Desktop application for the changes to take effect.

  2. Verify the Connection: Look for a hammer icon or a tool indicator in the bottom-right corner of the chat input box. Clicking this will show the available SQAI tools.

  3. Interact: Ask Claude to utilize your SQAI data.

    • Example: "Using the SQAI tools, look at my recent user stories and generate a test plan for the login feature."


Troubleshooting

Issue

Potential Cause

Solution

Hammer icon not visible

App not restarted.

Fully quit Claude (check the system tray/menu bar) and restart it.

Auth/Header Errors

Incorrect token format.

Ensure the header in your config is Authorization:your-key. Do not use "Bearer" here unless your specific key requires it; use the format shown in the snippet.

Connection failed

Node.js/npx not found.

Ensure Node.js is installed on your system. Run node -v and npx -v in your terminal to verify.

Logs and Debugging

Startup errors.

Check the logs at %APPDATA%\Claude\logs\mcp.log (Windows) or ~/Library/Logs/Claude/mcp.log (macOS) for connection errors.

JSON Syntax Error

Broken config file.

Ensure your claude_desktop_config.json is valid JSON. A missing comma or extra bracket will prevent Claude from loading any MCP servers.

Did this answer your question?