Skip to main content

MCP Server: Setup & Configuration

Written by Jameson

Setting up the Creative Force MCP Server involves two parts: a user role configuration step that governs how individuals interact with the MCP Server, and a connection step completed by each user for their chosen AI tool. This article covers both of these steps in detail.

🧪 Open Beta: The Creative Force MCP Server is currently in Open Beta. Supported AI tools and available features may change. To share feedback or report an issue, ask your AI assistant to use the Send Feedback tool.


Getting Started

Prerequisites

Before starting the setup process, it is assumed a number of prerequisites have already been completed. If you attempt to set up the Creative Force MCP Server prior to completing the prerequisites, you will not be able to proceed.

Prerequesite

Description

Read Overview

You have read the MCP Server: Overview article and understand the scope of functionality.

Role Permissions

You have enabled MCP Access Permissions for the specific user performing the configuration.

Role Permissions

If you want to use MCP Tools, you will need to set specific role permissions to Access. Setting permissions to access allows the AI Tools to become available.

  1. In Creative Force, navigate to Settings > User Roles

  2. Select a role, then 'Edit'

  3. Go to the MCP Server tab

  4. For each tool, select None or Access

  5. Click Save

⚠️ Important: All MCP tool permissions default to None for all standard roles. You must explicitly grant access. If you attempt to connect an app with an account without access permissions, the connection will fail.

🗣️ Tip: For a more individualized breakdown of what can be done and what is required for each Query Tool, please see our dedicated article here.

Connecting Claude

How you connect depends on which Claude product you use. Set up for each of the supported Claude interfaces can be found in the sections below.

Claude Web/Desktop

From claude.ai, or with the Claude Desktop Application launched– hit CustomizeConnectors → Then, hit the '+' to add a new connector. ​In the Connector browser, search for Creative Force, then hit 'Connect.'


A browser window will open– enter your credentials and click 'Log In.' Click Allow to authorise the MCP Server to access your Creative Force account.

🗣️Tip: Your login token is cached locally. You won't need to log in again until the token expires.

Enable Tool Permissions

Back in Claude settings, review the available tool permissions for the Creative Force connector. We recommend enabling all of them.

Claude Code

The Creative Force MCP Server is also available to connect directly through the Claude Code Command Line Interface, as well as the VS Code Extension.

Option A: CLI Command

claude mcp add --transport http "CreativeForce" https://mcp.creativeforce.io/mcp --client-id mcp --callback-port 9008

Option B: Manual Config

Add the following to .claude.json in your project root, or ~/.claude.json for a global configuration:

{   "mcpServers": {     "CreativeForce": {       "type": "http",       "url": "https://mcp.creativeforce.io/mcp",       "oauth": {         "clientId": "mcp",         "callbackPort": 9008       }     }   } }

VS Code Extension

Create .vscode/mcp.json In your project root:

{   "servers": {     "CreativeForce": {       "type": "http",       "url": "https://mcp.creativeforce.io/mcp",       "oauth": {         "clientId": "mcp"       }     }   } }

The VS Code Claude extension handles OAuth automatically– a browser window will open for Creative Force login on first use.

Connecting ChatGPT

Connecting the Creative Force MCP Server to Chat GPT is done via configuration of a custom connector in Developer Mode. Developer Mode is only available on Plus, Pro, Team, Enterprise, and Edu plans. Free ChatGPT does not support custom connectors and is therefore not available for connection to our MCP server.

Web App

In ChatGPT, open your account menu and go to Settings → Apps → Advanced Settingsthen, toggle on Developer Mode.

📝 Note: Developer mode carries an elevated risk warning from OpenAI. This is expected for custom MCP connectors that have not yet been marketplace-certified. It does not indicate a problem with the Creative Force Connector.

A Create App button will appear → Click Create App, then fill in the information as shown in the table below:

Field

Value

Name

Creative Force

MCP Server URL

https://mcp.creativeforce.io/mcp

Authentication

OAuth

Expand Advanced OAuth Settings. Set the OAuth Client ID to mcp. Check the "I understand and want to continue" box, then click 'Create.'

A pop-up window will appear, hit 'Sign in with Creative Force,' then follow the login steps in the browser pop-up.

After entering your credentials and logging in, click Allow to authorise the connection.

To use Creative Force in a chat, click the + icon in the message input, hover over More, and select Creative Force:

Troubleshooting

Problem

Solution

No tools visible after connecting

Your role doesn't have MCP tool permissions. Ask your Studio Admin to check role permissions.

The browser doesn't open for login

Check your internet connection and that the auth server is reachable.

401 error on every request

Your token may have expired. Restart the MCP client to re-authenticate.

Tools visible but returning "Access denied"

Permission cache may be stale– it refreshes every 10 minutes. Wait briefly and retry, or re-authenticate.

No results returned

Verify your Creative Force account has access to a studio with production data.

Connection timeout

Check that https://mcp.creativeforce.io/mcp is reachable from your network.

Next Steps

Now that you have connected your desired AI Tools, the setup process is complete. You can return to our overview article and review our tips on sending queries and submitting feedback.

Did this answer your question?