VOOZH about

URL: https://www.cdata.com/kb/tech/factorial-mcp-claude-desktop.rst

⇱ How to Query Live Factorial Data in Claude Desktop


How to Query Live Factorial Data in Claude Desktop

πŸ‘ Jerod Johnson
Jerod Johnson
Director, Technology Evangelism
Connect to and query live Factorial Data in Claude Desktop using CData MCP Server.

Model Context Protocol (MCP) is an emerging, open-source standard for connecting LLMs with external services and data sources. Through MCP Servers, AI clients can perform actions like opening Jira tickets, posting Slack messages, committing GitHub branches and more. With CData MCP Server, these capabilities expand exponentially.

CData MCP Server provides schema-aware context to AI tools β€” whether you're using it for AI-assisted code generation in IDEs like Cursor, or for querying live data through chat interfaces like Claude Desktop.

In this article, we guide the reader through installing CData API Driver for MCP Server, configuring the connection to Factorial, and asking questions of the data in Claude Desktop.

Prerequisites

You need to download Claude Desktop (download) and create an account before continuing.

Overview

Here's a quick overview of the steps:

  1. Download and install the CData API Driver for MCP Server
  2. Configure the connection to Factorial
  3. Ask questions about the data in Claude Desktop

Step 1: Download and install CData MCP Server

  1. To begin, navigate to https://www.cdata.com/solutions/codeassist/ and download the CData API Driver for MCP Server. πŸ‘ Downloading the CData MCP Server installer
  2. Find and double-click the installer to begin the installation. πŸ‘ Running the installer for CData MCP Server (Google Sheets is shown.)
  3. Follow the prompts to complete the installation. πŸ‘ Completing the CData MCP Server installation (Google Sheets is shown).

When the installation is complete, you are ready to configure MCP Server by connecting to Factorial.

Step 2: Configure the connection to Factorial

  1. After installation, the MCP Server configuration wizard should open automatically. πŸ‘ The MCP Server configuration wizard.

    NOTE: If the wizard does not open automatically, search for "CData MCP Server" in the Windows search bar and double-click the application. πŸ‘ Opening the MCP Server configuration wizard (Google Sheets is shown).

  2. Click the dropdown menu in MCP Configuration > Configuration Name and select "
  3. Name the configuration (e.g. "cdataapi") and click "OK."

    NOTE: This name is used as the name for the MCP server and as the prefix for all of the MCP Server's tools.

    πŸ‘ Naming the configuration.
  4. Connecting to Factorial

    Authentication

    Factorial uses OAuth 2.0 for authentication to connect to your HR data or to allow other users to connect to their data.

    Using OAuth Authentication

    To connect using OAuth, follow these steps:

    1. Navigate to your Factorial admin panel and create a new OAuth application.
    2. Copy the Client ID and Client Secret from your application configuration.
    3. Configure the following connection properties:

    After setting the following connection properties, you are ready to connect:

    • AuthScheme: Set this to OAuth.
    • OAuthClientId: Set this to your OAuth Client ID.
    • OAuthClientSecret: Set this to your OAuth Client Secret.
    • Scope: Set this to specify the data access permissions (default: "read write").

    Enter the appropriate connection properties in the configuration wizard.

    πŸ‘ Configuring the Server to connect with a specific Spreadsheet.
  5. Click "Connect" to authenticate with Factorial through OAuth. πŸ‘ Authenticating with Google

    NOTE: The configuration wizard should open your browser and ask you to sign into Factorial. If your browser does not open, close the configuration wizard and re-open the application using "Run as Administrator" (see below).

    πŸ‘ Running the configuration wizard with elevated permissions.
  6. Finally, click "Save Configuration" to save the configuration. πŸ‘ Saving the MCP Server configuration.

    NOTE: This saves the configuration details to a separate file and updates the Claude Desktop configuration file (claude_desktop_config.json) to start MCP Server when the Claude Desktop client starts.

With MCP Server configured, you are ready to start asking questions of your live data from Claude.

Step 3: Ask AI for answers from live Factorial data

Now that we have installed MCP Server and configured a connection, we are ready to start with Factorial data in Claude Desktop.

  1. Open Claude Desktop. It may take a moment for MCP Server to start, but you will see the list of servers and tools available in the Claude interface (look for the settings icon below the prompt bar). πŸ‘ The MCP servers menu showing available connections in Claude Desktop

    You can individually enable and disable specific tools by clicking on the server name. πŸ‘ The expanded tool list for MCP Server in Claude Desktop

  2. Now that you have connected, you can ask Claude questions about the Factorial data. For example: "Can you give me a quantitative analysis about my closed-won opportunities by industry?"

    NOTE: Claude may need to explore the Factorial data to make sense of it before it can begin answering questions of the data. The tabular model presented by CData alongside the database tools available simplify the data exploration and analysis for an LLM.

    πŸ‘ Claude Desktop displaying a quantitative analysis of live data

Build with MCP Server. Deploy with CData Drivers.

Download CData API Driver for MCP Server for free and give your AI tools schema-aware access to live Factorial data during development. When you're ready to move to production, CData API Drivers deliver the same SQL-based access with enterprise-grade performance, security, and reliability.

Visit the CData Community to share insights, ask questions, and explore what's possible with MCP-powered AI workflows.

Ready to get started?

Connect to live data from Factorial with the API Driver

Connect to Factorial