AI Setup Instructions

1. Formulize works with AI assistants that are capable of local MCP connections. You need to have one installed locally on your computer.

   We have had good results with Claude Desktop, and Claude helped create the Formulize MCP server. We can recommend it as a top tier AI assistant.

   However, to get the best results from Claude, a paid subscription seems to be necessary. The cost may be good value for money, if Claude can save you a lot of time, which seems likely given what AI and Formulize is capable of.

   Regardless, any AI assistant capable of using local MCP connections should be compatible with Formulize. Please let us know about your experience.

2. Create an API key in Formulize for the user(s) who are going to work with AI. You create API keys on the Manage API Keys page, accessible from the main Formulize admin page:
   

3. Enable the AI Features in Formulize. You do this through the Formulize Preferences page, , accessible from the main Formulize admin page:
   
   
   On that page, scroll down to the System Configuration section, and click Yes for the Enable AI Integration option:
   
   
   
   If the preference does not remain on, and instead reverts to no, then you need to add this code to the .htaccess file at the root of your website. Make sure to put it after any other rewrite rules.
   

   # Necessary for HTTP Authorization header to be passed through to the MCP server
   RewriteEngine On
   RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}]
   

4. Configure your AI assistant. For Claude Desktop, you can simply download the Formulize DXT extention, and install it in Claude. Unfortunately, the exact steps to install are changing regularly, and depend on which version of Claude you’re using.

   Other AI assistants might be compatible with DXT extensions as well, now or in the future.

5. If your AI assistant is does not support DXT extensions, you need to update the configuration of your AI assistant manually. Exactly how to do this varies from assistant to assistant:

   • For Copilot in VSCode, make a file called mcp.json in the .vscode folder of your project. It should look like this

    {
        "servers": {
            "My Formulize MCP Server": {
                "command": "npx",
                "args": [
                    "-y",
                    "formulize-mcp"
                ],
                "env": {
                    "FORMULIZE_URL": "https://<your.formulize.site.url>",
                    "FORMULIZE_API_KEY": "<your api key from your formulize site>",
                    "FORMULIZE_SERVER_NAME": "My Formulize MCP Server"
                }
            }
        }
    }
   

   • Also, in VSCode you will want to go into the preferences, and under Chat > MCP, make sure discovery is enabled.

   • For Claude Desktop, if you’re not using the DXT file, modify the file claude_desktop_config.json. Where is it?
     Windows: %APPDATA%\Claude\claude_desktop_config.json
     macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
     
     The file should look like this:

    {
        "mcpServers": {
            "My Formulize MCP Server": {
                "command": "npx",
                "args": [
                    "-y",
                    "formulize-mcp"
                ],
                "env": {
                    "FORMULIZE_URL": "https://<your.formulize.site.url>",
                    "FORMULIZE_API_KEY": "<your api key from your formulize site>",
                    "FORMULIZE_SERVER_NAME": "My Formulize MCP Server"
                }
            }
        }
    }
   

   • The configuration for other AI assistants should be similar. You need to use npx with formulize-mcp, and set the environment variables.

Options

There are five options you can configure in your AI assistant, for working with Formulize.

The DXT extension will give you a user interface to fill in with these options.

If you are manually configuring through a .json file, you need to include the options as the environment variables (env).

• FORMULIZE_URL - Required - The URL for your Formulize system, ie: https://myformulize.com
• FORMULIZE_API_KEY - Required - Your API key for your Formulize system.
• FORMULIZE_SERVER_NAME - Recommended - The name of your server. Although the name may be stated already higher up in the .json file, including the name as an environment variable will help the AI understand your system.
• FORMULIZE_DEBUG - Optional - Either true or false. Defaults to false.
• FORMULIZE_TIMEOUT - Optional - Timeout in milliseconds. Defaults to 30000.

Advanced Configuration

You can connect your AI assistant to multiple Formulize instances. You can also connect with the credentials of different users. Read more about these advanced configurations.