Skip to content

Connect your agent

SCMotif works through the agent you already use. Connect it once, and it can read your data, build and run workflows, and put the answer in front of you. SCMotif does the modelling underneath.

Every connection uses the same address:

https://demo.scmotif.com/api/mcp

There is no key to generate and nothing to paste. The first time the agent calls SCMotif, your browser opens on the SCMotif sign-in page. You sign in with your work account, and a consent screen asks what the agent may reach and whether it may write. Press Allow and the agent is connected. Signing in explains the two choices and how to withdraw them.

Claude

In Claude on the web or in the desktop app:

  1. Open Settings, then Connectors.
  2. Choose Add custom connector.
  3. Enter a name, for example SCMotif, and the address above as the remote MCP server URL. Leave the client ID and secret empty.
  4. Press Add, then Connect. Your browser opens on the SCMotif sign-in page. Sign in, choose what the agent may reach, and press Allow.
  5. In a new chat, open the tools menu and check that SCMotif is enabled.

Cowork uses the same connector. Once it is added to your Claude account, a Cowork task can call SCMotif like any other tool.

ChatGPT

In ChatGPT on the web:

  1. Open Settings, then Connectors.
  2. Under Advanced, turn on Developer mode. This allows a connector you add yourself.
  3. Choose Create, enter a name, the address above as the MCP server URL, and OAuth as the authentication.
  4. Press Create, then connect. Your browser opens on the SCMotif sign-in page. Sign in, choose what the agent may reach, and press Allow.
  5. In a new chat, enable the SCMotif connector from the tools menu.

Claude Code

From the directory you want to work in:

claude mcp add --transport http scmotif https://demo.scmotif.com/api/mcp

The first call opens your browser on the SCMotif sign-in page. Sign in and press Allow. Then /mcp inside Claude Code lists the connection and the tools it was granted.

Ask something

Talk to your agent normally. It reads the tool descriptions and works out which calls to make.

"Look at my SCMotif project called Demo: European Wine & Spirits. What does its network cost, and where does the money go?"

"Here's a spreadsheet of our lanes. Load it into SCMotif, check it makes sense, and tell me what's wrong with it before we model anything."

"Re-run the sourcing-shift workflow with this price list and show me what changed against the baseline."

The agent finds its way around your projects, looks at the data and scenarios they hold, builds a workflow, runs it, and reads the answer back to you. If it gets something wrong, SCMotif rejects the call with a diagnostic that says what is wrong, why, and how to fix it. The agent repairs the call and tries again.

Everything it builds stays. Workflows are named, versioned objects in your project. "Run it again with the new numbers" is one sentence next month.

See it in the app

Open demo.scmotif.com to see your projects, the data you uploaded, the workflows on a canvas, and any dashboard the agent deployed. The agent and the app work on the same data, so what the agent did is what you see. Every node on the canvas has a page in the node reference.

Troubleshooting

Each entry names what you see, why it happens, and what to do.

The agent lists no SCMotif tools

Cause: the connection was granted read-only, so the writing tools are not offered, or the grant has expired.

What to do: if you only need to read, nothing. Otherwise open your agent's connector settings, disconnect SCMotif, connect again, and choose Read and write on the consent screen.

Every call is answered "not authenticated"

Cause: the grant was withdrawn or has expired.

What to do: connect again from your agent's connector settings and sign in when the browser opens.

The agent says a project does not exist

Cause: the grant covers only the projects you chose on the consent screen, and this project is not one of them.

What to do: disconnect and connect again. On the consent screen choose My whole workspace, or add the project to the list.

A call is answered with a diagnostic

Cause: the call was wrong in a way SCMotif can name, such as a missing field or a step wired in the wrong order.

What to do: nothing. The message says what to change, and the agent repairs the call and tries again.