> For the complete documentation index, see [llms.txt](https://inistate.gitbook.io/home/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://inistate.gitbook.io/home/mcp-integration/getting-started.md).

# Getting Started

Connect your AI assistant to the hosted Inistate MCP endpoint in minutes.

The Inistate MCP server is hosted at `https://mcp.inistate.com`. You connect your AI assistant to it once; after that, the AI can access your workspace directly in conversation.

## Prerequisites

* An active Inistate account
* Claude (claude.ai or the Claude desktop app) or another MCP-compatible AI assistant

## Connect Your AI Assistant

{% tabs %}
{% tab title="Claude" %}
Inistate is available as an **official connector** in the Claude directory — no custom URL setup required.

{% stepper %}
{% step %}

### Open the Inistate connector

**On the web (claude.ai)** — just open the connector directly:

[claude.ai/directory/connectors/inistate](https://claude.ai/directory/connectors/inistate)

**On the Claude desktop app** — deep links aren't supported, so find it manually:

1. Go to **Settings → Connectors** and click **Add ▾ → Browse connectors**.

![Browse connectors](https://1790119986-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMq4WvP70cd4YzBbY6Mue%2Fuploads%2Fgit-blob-b5556653768dceb4754c5f13135c1f192b2eb4c1%2Fclaude-browse-connectors.png?alt=media)

2. Search for **inistate**, then click the **+** to add it.

![Search for the Inistate connector](https://1790119986-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMq4WvP70cd4YzBbY6Mue%2Fuploads%2Fgit-blob-7f84cbe2cce621a23f5f1df0f03d9246fbc88e08%2Fclaude-search-connector.png?alt=media)
{% endstep %}

{% step %}

### Connect

On the Inistate connector page, click **Connect**.

**On the web (claude.ai):**

![Connect to Inistate on the web](https://1790119986-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMq4WvP70cd4YzBbY6Mue%2Fuploads%2Fgit-blob-1407f8c1ac591869d316598e6920bebca6c33289%2Fclaude-connect.png?alt=media)

**On the Claude desktop app:**

![Connect to Inistate on the desktop app](https://1790119986-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMq4WvP70cd4YzBbY6Mue%2Fuploads%2Fgit-blob-b9187e5d0e47f3da477ef0a701fba85c9aca44bb%2Fclaude-connect-desktop.png?alt=media)

Claude will prompt you to log in to your Inistate account and authorize access. Once complete, you'll see a **"Connected to Inistate"** confirmation.

![Connected to Inistate](https://1790119986-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMq4WvP70cd4YzBbY6Mue%2Fuploads%2Fgit-blob-c1ea5e37aeb70cff2fa719d5e5670f32fd154b87%2Fclaude-connected.png?alt=media)
{% endstep %}

{% step %}

### (Optional) Set project instructions

For the most reliable experience, create a Claude **Project** for Inistate and add instructions so Claude consistently uses the connector.

![Set project instructions](https://1790119986-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMq4WvP70cd4YzBbY6Mue%2Fuploads%2Fgit-blob-b163046fbaff0c08e39b4afd885dd005f419b8e5%2Fclaude-project-instructions.png?alt=media)
{% endstep %}
{% endstepper %}
{% endtab %}

{% tab title="ChatGPT" %}

1. Go to [chatgpt.com/apps/inistate](https://chatgpt.com/apps/inistate) and click **Install plugin**.

![](https://1790119986-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMq4WvP70cd4YzBbY6Mue%2Fuploads%2Fgit-blob-77c8fa5e3886f0e8c6cf58c3465e49bae9175045%2Fchatgpt-connect.png?alt=media)

2. A dialog will appear to add Inistate to ChatGPT. Click **Sign in with Inistate**.

![](https://1790119986-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMq4WvP70cd4YzBbY6Mue%2Fuploads%2Fgit-blob-06e740b349ef2d1e506a33f942b7b3d5d64ba729%2Fchatgpt-sign-in.png?alt=media)

3. You will be redirected to Inistate. If you are **not** signed in, log in with any method — or click **Sign up** if you don't have an account yet.

![](https://1790119986-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMq4WvP70cd4YzBbY6Mue%2Fuploads%2Fgit-blob-82991af35b6b0778a87e43a22a809841bd65d5b3%2Fchatgpt-login-page.png?alt=media)

If you are **already** signed in, you'll see the authorize screen instead. Click **Authorize** to grant ChatGPT access to your account.

![](https://1790119986-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMq4WvP70cd4YzBbY6Mue%2Fuploads%2Fgit-blob-ce75d58880ff555a1d7c713cdf008d6d1c55446e%2Fchatgpt-authorize.png?alt=media)

4. If you chose to sign up, complete the flow with your preferred method — for example, signing up with Google.

![](https://1790119986-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMq4WvP70cd4YzBbY6Mue%2Fuploads%2Fgit-blob-a079330c74673c3b15bb9f93069d20a40ffccc96%2Fchatgpt-google-signup.png?alt=media)

5. You'll be taken back to ChatGPT. You should see **"Inistate is installed."**

![](https://1790119986-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMq4WvP70cd4YzBbY6Mue%2Fuploads%2Fgit-blob-bbcae0a03cc38482fd39f5fd7fe8d11f4ff87800%2Fchatgpt-connected.png?alt=media)

6. In the chat input bar, click the **+** button and select **Inistate**.

![](https://1790119986-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMq4WvP70cd4YzBbY6Mue%2Fuploads%2Fgit-blob-78a8b5031186c056354cbc4e7717657b43510f51%2Fchatgpt-use.png?alt=media)

7. Inistate will appear in the chat input bar. You can now chat with your workspace data directly in ChatGPT — for example, ask it to list your workspaces.

![](https://1790119986-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMq4WvP70cd4YzBbY6Mue%2Fuploads%2Fgit-blob-7ca3b1df96106decce5c6f90f8809421c4276119%2Fchatgpt-chat.png?alt=media)

8. ChatGPT calls Inistate and returns your data.

![](https://1790119986-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMq4WvP70cd4YzBbY6Mue%2Fuploads%2Fgit-blob-e61c4b6ba82738a3e823141abf3e74bbfa0693cf%2Fchatgpt-result.png?alt=media)
{% endtab %}
{% endtabs %}

## Verify the Connection

Once connected, ask your AI assistant:

> "List my Inistate modules."

The AI will call `list_workspaces`, ask you to confirm your workspace, then return the modules available in it. If you see your module list, you're ready to go.

{% hint style="info" %}
The server starts in **configure mode** by default, which gives you both entry operations and module design tools. If you only need to work with entries, ask the AI to switch to runtime mode: *"Switch to runtime mode."*
{% endhint %}

## What's Next

| I want to...                   | Go to                                                                 |
| ------------------------------ | --------------------------------------------------------------------- |
| Query, create, or edit entries | [Working with Entries](/home/mcp-integration/working-with-entries.md) |
| Attach or retrieve files       | [File Uploads & Downloads](/home/mcp-integration/file-uploads.md)     |
| Design a new workflow module   | [Designing Modules](/home/mcp-integration/designing-modules.md)       |
| Modify an existing module      | [Modifying Modules](/home/mcp-integration/modifying-modules.md)       |
| Build a custom UI              | [Building Custom UIs](/home/mcp-integration/building-custom-uis.md)   |
