MCP (Model Context Protocol) Support

Overview

MCP (Model Context Protocol) is a standardized protocol for connecting external tools and data sources to language models.
By supporting and integrating with MCP, Sprouti can extend workflows for editing, search, and automation.

Key Benefits

Connect to various tools via a standardized interface
Combine Sprouti operations with MCP tool invocations for efficiency

Prerequisites

An application capable of MCP integration
Latest version of Sprouti (MCP-enabled)

Note: Please follow each provider's setup and authentication procedures for MCP server configuration. Sprouti does not guarantee the availability or permission settings of connection targets.

Setup Steps

1. Check the server.js path in Sprouti's MCP settings panel and add it to the configuration file of the partner application.
2. Launch Sprouti first, then the partner application
3. Verify that the tools are recognized in the partner application.

Specific screen names and field labels may vary depending on your version. We will progressively add detailed step-by-step instructions following the UI.

Claude Desktop Sample Configuration

Add the following MCP server definition to the Claude Desktop configuration file to connect to Sprouti's MCP server.
Adjust the command and args paths to match your environment. Replace <username> with your actual username.

{
  "mcpServers": {
    "sprouti": {
      "command": "/Users/<username>/.nodebrew/current/bin/node",
      "args": ["/Applications/Sprouti.app/Contents/Resources/mcp/server.js"],
      "env": {
        "PATH": "/Users/<username>/.nodebrew/current/bin:/usr/local/bin:/usr/bin:/bin"
      }
    }
  }
}

For Windows, please refer to the following configuration:

{
  "mcpServers": {
    "sprouti": {
      "command": "C:\Program Files\nodejs\node.exe",
      "args": ["C:\Users\<username>\sprouti\dist\mcp\server.js"],
      "env": {
        "PATH": "C:\Program Files\nodejs;C:\Windows\System32;C:\Windows"
      }
    }
  }
}

Codex CLI Sample Configuration

Add the following MCP server definition to your config.toml configuration file.
Adjust the command and args paths to match your environment. Replace <username> with your actual username.

[mcp_servers.sprouti]
command = "/Users/<username>/.nodebrew/current/bin/node"
args = ["/Applications/Sprouti.app/Contents/Resources/mcp/server.js"]
env.PATH = "/Users/<username>/.nodebrew/current/bin:/usr/local/bin:/usr/bin:/bin"

For Windows, add the following setting based on the path displayed in the settings screen:

SPROUTI_MCP_AUTH_PATH = "C:\Users\<YourUser>\AppData\Local\Packages\<PFN>\LocalCache\Roaming\sprouti\sprouti-mcp-auth.txt"

Key Points

command: Specifies the path to your Node.js binary
args: Specifies the path to Sprouti's MCP server script (refer to the MCP section in Sprouti's settings panel for the correct path)

Note: The paths above are examples. If they don't exist on your system, please update them to the correct paths for your environment.

Usage Examples

Example 1: Invoke an External Search Tool

Run a search tool via MCP from Sprouti
Paste results into a document and organize them

Example 2: Automated Document Processing

Use an MCP tool to summarize/format content and reflect in Sprouti
Combine with templates to streamline routine workflows

Security & Best Practices

Avoid connecting to untrusted MCP servers
Manage API keys securely and apply least privilege
Ensure logs do not contain sensitive data

Common Issues & Solutions

Cannot Connect

Verify Sprouti is running
Restart Sprouti first, then the partner application

JetBrains AI Assistant Connection Unstable

If the connection from JetBrains AI Assistant via MCP is unstable, add the following setting to the env section in your configuration:

"SPROUTI_MCP_LOG_LEVEL": "error"

This setting limits the log level to errors only, which may improve connection stability.