Skip to content

Using Pleasanter MCP with Other AI Agents

Overview

Pleasanter MCP can also be used with AI agents other than Claude Desktop and Visual Studio Code.

Check the manual of each AI agent for the file in which the MCP server settings should be written, and paste the following content into it.

When you use only Pleasanter MCP as the MCP server
{
  "mcpServers": {
    "pleasanter": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "http://{server name}/{path}/mcp",
        "--transport",
        "http-first",
        "--header",
        "X-API-Key:<API key>",
        "--allow-http"
      ]
    }
  }
}

Remote MCP Server Endpoint

Specify the MCP server endpoint in the part on line 8 above.

http://{server name}/{path}/mcp
  1. {server name} and {path} can differ depending on how you set up Pleasanter.
  2. Check the URL you actually use and change it as needed.
  3. The following are examples of the URL in each environment.

    Server Name Path Example of the URL
    localhost none http://localhost/mcp
    example.com pleasanter https://example.com/pleasanter/mcp

Most problems connecting to the MCP server are caused by a mistake in editing this file. If the settings do not work, refer to FAQ: What to check if modified configuration files or API requests (JSON format) are not recognized correctly.

API Key

For on line 12 above, specify the API key issued in Pleasanter.

An API key is credential information that should be managed at the same level as a login password. We recommend that you register the API key in an environment variable and specify the name of the environment variable in the AI agent's configuration file.

  1. How to register an environment variable differs depending on the OS, the shell and so on. Check the manual for each of them.
  2. For the notation used to refer to the value of an environment variable in an AI agent's configuration file, check the manual of each AI agent.
  3. The name of the environment variable is up to you (for example PLEASANTER_API_KEY).

Supported Versions

Supported Version Description
1.5.2.0 and later Function added