Targetprocess MCP server for AI agents

The Targetprocess MCP Server allows you to control your Targetprocess project management platform through natural language conversations with AI assistants. It implements the Model Context Protocol (MCP) to enable semantic AI-powered operations alongside traditional API access.

Installation Options

Using Claude Desktop

{
  "mcpServers": {
    "targetprocess": {
      "command": "npx",
      "args": ["-y", "https://github.com/aaronsb/apptio-target-process-mcp.git"],
      "env": {
        "TP_DOMAIN": "your-domain.tpondemand.com",
        "TP_API_KEY": "your-api-key"
      }
    }
  }
}

Using Claude Code

# Add to project
claude mcp add targetprocess npm run targetprocess

# Configure .env
TP_DOMAIN=your-domain.tpondemand.com
TP_API_KEY=your-api-key

Using Docker

# With API key (recommended)
docker run -i --rm \
  -e TP_DOMAIN=your-domain.tpondemand.com \
  -e TP_API_KEY=your-api-key \
  ghcr.io/aaronsb/apptio-target-process-mcp

# With role-specific tools and strict mode
docker run -i --rm \
  -e TP_DOMAIN=your-domain.tpondemand.com \
  -e TP_USERNAME=your-username \
  -e TP_PASSWORD=your-password \
  -e TP_USER_ROLE=developer \
  -e TP_USER_ID=your-user-id \
  -e TP_USER_EMAIL=your-email \
  -e MCP_STRICT_MODE=true \
  ghcr.io/aaronsb/apptio-target-process-mcp

Using NPX

# With API key (recommended)
TP_DOMAIN=your-domain.tpondemand.com TP_API_KEY=your-api-key \
  npx -y https://github.com/aaronsb/apptio-target-process-mcp.git

# With role-specific tools and strict mode
TP_DOMAIN=your-domain.tpondemand.com TP_USERNAME=your-username TP_PASSWORD=your-password \
TP_USER_ROLE=developer TP_USER_ID=your-user-id TP_USER_EMAIL=your-email \
MCP_STRICT_MODE=true \
  npx -y https://github.com/aaronsb/apptio-target-process-mcp.git

Configuration

API Authentication

Option 1: API Key (Recommended)

Go to Targetprocess → Settings → Access Tokens
Create a new token
Set TP_API_KEY environment variable

Option 2: Basic Auth

Set both:

TP_USERNAME: Your Targetprocess username
TP_PASSWORD: Your Targetprocess password

Security Note: Never commit credentials to version control. Use environment variables or .env files (gitignored).

Available Tools

The server provides these MCP tools to AI assistants:

Tool	Description
search_entities	Search with powerful filtering, sorting, and includes
get_entity	Retrieve detailed entity information
create_entity	Create new work items with validation
update_entity	Update existing entities
inspect_object	Explore entity types and properties

Role-Specific Tools

When you configure a user role, you get additional specialized tools:

Role	Additional Tools
`developer`	`show_my_tasks`, `start_working_on`, `complete_task`, `show_my_bugs`, `log_time`
`project-manager`	Project oversight and team management tools
`tester`	Test case and bug management tools
`product-owner`	Backlog and feature prioritization tools

# Enable role-specific tools
TP_USER_ROLE=developer        # Your role
TP_USER_ID=your-user-id       # For assignments
TP_USER_EMAIL=your-email      # For identification

Environment Variables Reference

Variable	Required	Description
`TP_DOMAIN`	Yes	Your Targetprocess domain (e.g., company.tpondemand.com)
`TP_API_KEY`	Yes*	API key for authentication (recommended)
`TP_USERNAME`	Yes*	Username for basic authentication
`TP_PASSWORD`	Yes*	Password for basic authentication
`TP_USER_ROLE`	No	Enable role-specific tools: `developer`, `project-manager`, `tester`, `product-owner`
`TP_USER_ID`	No	Your Targetprocess user ID (for assignments)
`TP_USER_EMAIL`	No	Your email (for identification)
`MCP_STRICT_MODE`	No	Set to `true` for MCP clients requiring clean JSON-RPC

*Either API key or username/password required

Example Usage Scenarios

You can ask your AI assistant:

"Show me all open user stories in the mobile app project"
"Create a bug for the authentication failure on the login page"
"What's the status of our Q2 release?"
"Update the priority of story #12345 to high"
"Show me all tasks assigned to Sarah"
"Which team has the most open bugs right now?"

Developer Role Features

When configured with TP_USER_ROLE=developer, these additional tools become available:

show_my_tasks: View assigned tasks with smart filtering and priority analysis
start_working_on: Begin work on tasks with automatic state transitions
complete_task: Mark tasks complete with integrated time logging and comments
show_my_bugs: Analyze assigned bugs with dynamic severity categorization
log_time: Record time with intelligent entity type discovery and validation
add_comment: Add contextual comments with workflow-aware follow-up suggestions

How to install this MCP server

For Claude Code

To add this MCP server to Claude Code, run this command in your terminal:

claude mcp add-json "targetprocess" '{"command":"docker","args":["run","-i","--rm","-e","TP_USERNAME","-e","TP_PASSWORD","-e","TP_DOMAIN","-e","TP_USER_ROLE","-e","TP_USER_ID","-e","TP_USER_EMAIL","-e","MCP_STRICT_MODE","ghcr.io/aaronsb/apptio-target-process-mcp:latest"],"env":{"TP_USERNAME":"your-username","TP_PASSWORD":"your-password","TP_DOMAIN":"your-domain.tpondemand.com","TP_USER_ROLE":"developer","TP_USER_ID":"your-user-id","TP_USER_EMAIL":"[email protected]","MCP_STRICT_MODE":"true"},"disabled":false,"transportType":"stdio"}'

See the official Claude Code MCP documentation for more details.

For Cursor

There are two ways to add an MCP server to Cursor. The most common way is to add the server globally in the ~/.cursor/mcp.json file so that it is available in all of your projects.

If you only need the server in a single project, you can add it to the project instead by creating or adding it to the .cursor/mcp.json file.

Adding an MCP server to Cursor globally

To add a global MCP server go to Cursor Settings > Tools & Integrations and click "New MCP Server".

When you click that button the ~/.cursor/mcp.json file will be opened and you can add your server like this:

{
    "mcpServers": {
        "targetprocess": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "-e",
                "TP_USERNAME",
                "-e",
                "TP_PASSWORD",
                "-e",
                "TP_DOMAIN",
                "-e",
                "TP_USER_ROLE",
                "-e",
                "TP_USER_ID",
                "-e",
                "TP_USER_EMAIL",
                "-e",
                "MCP_STRICT_MODE",
                "ghcr.io/aaronsb/apptio-target-process-mcp:latest"
            ],
            "env": {
                "TP_USERNAME": "your-username",
                "TP_PASSWORD": "your-password",
                "TP_DOMAIN": "your-domain.tpondemand.com",
                "TP_USER_ROLE": "developer",
                "TP_USER_ID": "your-user-id",
                "TP_USER_EMAIL": "[email protected]",
                "MCP_STRICT_MODE": "true"
            },
            "disabled": false,
            "transportType": "stdio"
        }
    }
}

Adding an MCP server to a project

To add an MCP server to a project you can create a new .cursor/mcp.json file or add it to the existing one. This will look exactly the same as the global MCP server example above.

How to use the MCP server

Once the server is installed, you might need to head back to Settings > MCP and click the refresh button.

The Cursor agent will then be able to see the available tools the added MCP server has available and will call them when it needs to.

You can also explicitly ask the agent to use the tool by mentioning the tool name and describing what the function does.

For Claude Desktop

To add this MCP server to Claude Desktop:

1. Find your configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

2. Add this to your configuration file:

{
    "mcpServers": {
        "targetprocess": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "-e",
                "TP_USERNAME",
                "-e",
                "TP_PASSWORD",
                "-e",
                "TP_DOMAIN",
                "-e",
                "TP_USER_ROLE",
                "-e",
                "TP_USER_ID",
                "-e",
                "TP_USER_EMAIL",
                "-e",
                "MCP_STRICT_MODE",
                "ghcr.io/aaronsb/apptio-target-process-mcp:latest"
            ],
            "env": {
                "TP_USERNAME": "your-username",
                "TP_PASSWORD": "your-password",
                "TP_DOMAIN": "your-domain.tpondemand.com",
                "TP_USER_ROLE": "developer",
                "TP_USER_ID": "your-user-id",
                "TP_USER_EMAIL": "[email protected]",
                "MCP_STRICT_MODE": "true"
            },
            "disabled": false,
            "transportType": "stdio"
        }
    }
}

3. Restart Claude Desktop for the changes to take effect