TerriToolChatGPT setup

ChatGPT setup tutorials

Choose your role. Copy one prompt for the task you want to do.

Create your Project first

Set up a dedicated TerriTool Project before starting the MCP conversation.

Choose the setup that matches your app. The screenshots show the desktop Project creation flow.

Already have a Project? Use MCP in your chat ↓
ChatGPT Project. Open Projects, choose New project or the + control, enter a name, and create it. Open a chat in the Project, select TerriTool, then copy a task prompt from your role page. Your manager can optionally add saved Project instructions. A ChatGPT Project uses uploaded files and sources rather than a local source folder.

Codex / desktop Project setup

  1. Click + beside Projects.

    Find Projects in the sidebar and click the + on its right.

    Click + to create a Project
    Projects sidebar heading with a plus button on the right
    Click the + button beside Projects. Enlarge image ↗
  2. Name the Project.

    Enter TerriTool — Field Sales or TerriTool — Manager in Project name.

    Under Source folders, use Add if you want this Project to access a folder on your computer, if your manager has given you local files. You do not need a folder or knowledge file just to copy a task prompt. A local folder is not the MCP connection.

    Enter your Project name
    Create project dialog showing Project name and optional Source folders
    Enter a name; attach a source folder if you need local files. Enlarge image ↗
  3. Click Create project.

    Save the Project using the Create project button at the bottom right.

    Click Create project
    Full Create project dialog, with the Create project button highlighted at the bottom right
    Click Create project to finish. Enlarge image ↗
  4. Start a chat in the Project.

    Open the new Project and start a new chat or task. Use your installed role plugin. Choose a task prompt from your role page and paste it into the chat.

    Then follow Use MCP in a Project chat below to select TerriTool and check its tools.

Creating a Project does not connect TerriTool. Complete the plugin installation and TerriTool sign-in from your role tutorial, then select the connected plugin in the new chat.

Reference: ChatGPT and local Projects.

Use MCP in a Project chat

After connecting TerriTool, select it inside your ChatGPT Project to work with live accounts, routes, and team data.

Not connected yet? Follow the setup tutorial for your role above first.

  1. Open your TerriTool Project.

    Choose your Field Sales or Manager Project in ChatGPT, then start a new chat inside that Project.

    Open your Project and start a new chat. Illustrated example, not a screenshot.
    Illustrated example: start the chat inside your role’s Project. Enlarge image ↗
  2. Select TerriTool in the chat.

    Type @ in the message box, search for TerriTool, and select your installed plugin from the suggestions. Its name may match the connection name you chose during setup.

    Type @ and select TerriTool from plugin suggestions. Illustrated example, not a screenshot.
    Illustrated example: select the actual installed plugin. Enlarge image ↗
  3. Check that MCP tools are available.

    With TerriTool selected, send this request:

    CONNECTION CHECK
    Use TerriTool. Check which tools are available to this chat. If a read-only account lookup is available, use it to verify my connection. Do not save leads, buy contacts, assign accounts, or publish routes.

    Check for a TerriTool tool call and its returned result. A message saying “connected” alone does not verify access.

    Inspect the TerriTool tool call and returned result. Illustrated example, not a screenshot.
    Illustrated example: verify a real tool result; no account data is shown. Enlarge image ↗
  4. Ask for your sales task.

    Choose a field sales task prompt or a manager task prompt. Click Copy prompt, paste it into your TerriTool chat, and press Send. Answer one question at a time. Continue in this Project chat; select TerriTool again when starting another chat where you want to use it explicitly.

Project files do not connect MCP. Instructions and knowledge files provide context. You still need the installed, authenticated TerriTool connection. Pasting the MCP URL into a message does not enable its tools.

TerriTool is missing from the chat

Check that you are in the same ChatGPT workspace where TerriTool is installed. Open Plugins, complete the TerriTool connection if needed, then start a new chat in your Project. If your workspace or chat mode does not offer the plugin, ask your administrator to enable a supported connection.

See the official guides for using plugins and Project chats.