PPM Express Help Center

What do you need help with?

How to connect PPM Express to Claude

This article describes how to connect your PPM Express account to Claude using the Model Context Protocol (MCP). Once connected, you can use Claude to retrieve information about your PPM Express portfolios, programs, projects, resources, and ideas directly from a conversation.

You can configure the connection using either Claude on the web or the Claude desktop application. The connection is saved to your Claude account, so you only need to configure it once to use it in both versions.


Before you begin

Before setting up the connection, make sure you have:

  • A Claude account that supports custom connectors. Custom connectors are available on all Claude plans, but the Free plan allows only one custom connector.
  • A PPM Express account with access to the workspace (tenant) you want to connect.
  • The required permissions to configure custom connectors in Claude.
Delete

Note: If you use a Claude Team or Enterprise plan, your organization owner may need to add the PPM Express connector first. Refer to the For Claude organization owners section below.


Connect PPM Express to Claude

The following steps apply to both Claude on the web and the Claude desktop application.

To configure the PPM Express connection, perform the following:

1. Sign in to Claude.

Open Claude in your browser or launch the Claude desktop application and sign in to your account.

2. Open the connector settings.

Navigate to Settings → Connectors. Depending on your Claude version, you can also access the connector settings from the left navigation menu under Customize or Plugins.

3. Add a custom connector.

Click Add (or the plus icon) and select Add custom connector.

4. Enter the connection details.

In the connector configuration form, provide the following information:

Field Value
Name PPM Express
Remote MCP server URL https://mcp.ppm.express/mcp
OAuth Client ID Leave empty
OAuth Client Secret Leave empty

Click Continue to proceed.

Delete

Important: Do not enter a Client ID (including mcp) or Client Secret. These fields must remain empty for authentication to work correctly. Entering a value may cause an Invalid parameter: redirect_uri error.


5. Confirm the authentication settings.

Claude should automatically detect the required authentication settings:

  • Authentication: Sign in now
  • OAuth client: Use Claude's published identity
  • Keep the detected settings unchanged. Do not modify the Advanced settings or enter a Client ID or Secret.


Click Add to create the connector.

6. Authorize your PPM Express account.

The PPM Express sign-in page will open in a new browser tab or authentication window, depending on whether you are using Claude on the web or the desktop application.

Sign in using your PPM Express account credentials.

7. Select your PPM Express workspace.

After signing in, select the PPM Express workspace (tenant) you want to connect to Claude.

The connector will use the selected workspace to retrieve information from PPM Express.

Delete

Note: You can connect to only one PPM Express workspace at a time. To switch to another workspace, disconnect the existing connection and connect again, selecting the required workspace.


8. Verify the connection.

Once authorization is completed, you will be redirected to Claude.

Open Settings → Connectors and make sure PPM Express appears with the Connected status.

If the connector is connected successfully, you can proceed with configuring its permissions.


Configure PPM Express connector permissions

After connecting PPM Express to Claude, you can configure which actions Claude is allowed to perform using the available MCP tools.

For everyday use, it is recommended to allow read-only operations and require approval for actions that modify data in PPM Express.

To configure the connector permissions, perform the following:

1. Open the PPM Express connector settings.

In Claude, navigate to Settings → Connectors and select PPM Express.

2. Open the Permissions tab.

Select the Permissions tab to view the available tools and their permission settings.

The tools are organized into read-only tools and tools that can modify data.

3. Configure read-only tool permissions.

For read-only operations, set the permission level to Always allow.

You can use the drop-down menu for the entire group or configure each tool individually.

The following six tools provide read-only access to PPM Express data:

Tool Description
Get Context Retrieves the available item types in your PPM Express workspace.
Get Items Retrieves information about portfolios, programs, projects, resources, ideas, and users.
Get Items Summary View Retrieves summary information about PPM Express items.
Get Subitem Retrieves details of an individual subitem.
Get Subitems Retrieves project details such as tasks, risks, issues, and key dates.
Get My Info Retrieves information about your PPM Express user account.

With Always allow selected, Claude can use these tools without requesting approval for each operation.

4. Configure permissions for tools that modify data.

The following tools can create, update, or perform actions on PPM Express data:

  • Create or Update Item
  • Create or Update Subitem
  • Execute Action
  • For these tools, select one of the following permission levels:
  • Needs approval: Claude requests approval before performing an action, subject to Claude's permission handling.
  • Never: Claude is not allowed to use the tool.
Delete

Note: If you plan to use Claude only to retrieve information from PPM Express, it is recommended to set all tools that modify data to Never.


In Claude's Auto mode, automated permission checks may allow certain actions without a separate approval prompt, even when Needs approval is selected.

5. Save the permission settings.

The changes are saved automatically and apply to both Claude on the web and the desktop application.


Available permission levels

Permission Description
Always allow (✓) Claude can use the tool without requesting approval.
Needs approval (hand icon) Claude may request your approval before using the tool.
Never (⊘) Claude cannot use the tool.
Delete

Note: Claude can access only the information available to your PPM Express account. Your existing PPM Express access permissions remain in effect.


Use PPM Express in Claude

Once the connector is configured, you can start using Claude to retrieve and analyze information from your PPM Express workspace.

To use PPM Express in a Claude conversation, perform the following:

1. Start a new conversation.

Open Claude on the web or in the desktop application and start a new chat.

2. Enable the PPM Express connector.

Click the + button in the message field and select Connectors.

Make sure the PPM Express connector is enabled.

3. Ask Claude about your PPM Express data.

Enter a question or request related to your PPM Express workspace.

For example: Show me the projects in the AI Transformation 2027 portfolio. Or: What risks are open on the Sales Copilot Rollout project?

To quickly verify that the connection works correctly, you can also enter: Who am I in PPM Express?

Claude will use the PPM Express connector to retrieve the requested information and display the results in the conversation.

4. Approve actions if required.

If Claude needs to use a tool configured with Needs approval, an approval request may appear.

Review the requested action and select whether to allow or deny it.


Claude web and desktop application

The PPM Express connector works in both Claude on the web and the desktop application.

Setting Claude on the web Claude desktop application
Connector setup Settings → Connectors Settings → Connectors
PPM Express authentication Opens in a browser tab Opens in an authentication window or browser
Connection configuration Configured once Uses the same connection
Tool permissions Shared with desktop Shared with web
Delete

Note: You do not need to configure the PPM Express connector separately for the web and desktop applications. The connection and permission settings are shared across both versions.


For Claude organization owners (Team and Enterprise)

If your organization uses a Claude Team or Enterprise plan, an organization owner can add the PPM Express connector for all organization members.

To configure the connector at the organization level, perform the following:

1. Open the organization connector settings.

In Claude, navigate to Organization settings → Connectors.

2. Add a custom connector.

Click Add, hover over Custom, and select Web.

3. Enter the PPM Express connection details.

Provide the following information:

Field Value
Name PPM Express
Remote MCP server URL https://mcp.ppm.express/mcp
Client ID Leave empty
Client Secret Leave empty

Click Add to create the connector.

4. Enable the connector for organization members.

Once the connector is added, organization members can navigate to Settings → Connectors, locate PPM Express, and click Connect.

Each user must sign in using their own PPM Express account, select the required workspace, and configure the tool permissions as described above.


Troubleshooting

If you encounter any issues while configuring or using the PPM Express connector, review the following recommendations.

1. The error "Invalid parameter: redirect_uri" appears during authentication.

This error may occur if a Client ID was entered during connector configuration.

Remove the existing connector and create it again, leaving both the Client ID and Client Secret fields empty.

Note: Editing the existing connector is not sufficient. You need to remove it and create a new connection.

2. The error "Client not found" appears.

Remove the connector and add it again, making sure the Client ID and Client Secret fields are left empty.

3. The error "Restart login cookie not found" appears.

This error may occur if the authentication page has expired or was opened more than once.

Close the authentication tab, return to Claude, open the PPM Express connector settings, and click Connect again.

If PPM Express already appears as Connected, you can ignore this message.

4. The connector is connected, but Claude does not use PPM Express.

In the Claude conversation, click + → Connectors and make sure PPM Express is enabled.

Start a new conversation and retry your request.

5. Claude requests approval for every read-only operation.

Open the PPM Express connector permissions and set the read-only tools to Always allow.

6. Claude displays information from the wrong workspace or some data is missing.

Disconnect the PPM Express connector and connect again, selecting the correct workspace.

If the expected items are still missing, verify that your PPM Express account has access to them.

7. Authentication continues to fail.

Sign out of PPM Express in your browser, return to Claude, and click Connect again.

If the issue persists, contact PPM Express support.


Security recommendations

When connecting PPM Express to Claude, enter your account credentials only on the official PPM Express sign-in page.

Do not share passwords, verification codes, client secrets, or access tokens in Claude conversations.

For additional security, configure the tools that modify PPM Express data to Never if you only need read-only access.

Was this article helpful?

Table of contents



    G2 Reviews - PPM Express

    Love PPM Express? Leave us a review on G2!

    Back To Top