# Connect Claude to your JointTex projects

**URL:** <https://forum.jointtex.com/t/connect-claude-to-your-jointtex-projects/13>\
**Category:** General\
**Tags:** ai-agent, collab, mcp\
**Created:** [October 8, 2026, 6:03pm UTC](https://forum.jointtex.com/t/connect-claude-to-your-jointtex-projects/13 "2026-10-08T18:03:46Z")\
**Posts on this page:** 2\
**Page:** 1

<div class="post-metadata">

**Author:** ![JointTex\_Admin](https://forum.jointtex.com/user_avatar/forum.jointtex.com/jointtex_admin/32/12_2.png) [@JointTex\_Admin](https://forum.jointtex.com/u/JointTex_Admin)\
**Post date:** [October 8, 2026, 6:03pm UTC](https://forum.jointtex.com/t/connect-claude-to-your-jointtex-projects/13/1 "2026-10-08T18:03:46Z")

</div>

# Connect Claude to your JointTex projects

JointTex works as a connector in Claude. Once it is connected, you can ask Claude to read your paper, edit the source, compile it, and reply to review comments, all from a Claude conversation, on the same live project your coauthors have open in the editor.

Setup takes about a minute. There is no token to copy: you paste one address into Claude and sign in to JointTex when it asks.

## What you need

- A JointTex account on Education, Plus, or Pro.
- The Claude app, with access to custom connectors.

## Step 1: Open Customize and add a connector

In Claude, open **Customize** in the sidebar and go to the **Connectors** tab. Click **Add** and choose to add a custom connector.

 ![Claude's Customize page, with the Connectors tab and the Add button](https://forum.jointtex.com/uploads/default/original/1X/8ae56fa1bcbe78b55e1d8274d191c15ffe8d0e4b.png)

## Step 2: Enter the JointTex address

Give the connector a name (this is only the label in your connectors list) and paste the server address:

```auto
https://jointtex.com/mcp

```

Then click **Continue**.

 ![The Add custom connector dialog with the name jointtex and the address https://jointtex.com/mcp](https://forum.jointtex.com/uploads/default/original/1X/f3c24966e8bed8b4fcd58e3d5030127a42e4bbef.png)

## Step 3: Keep the detected sign-in settings

Claude asks the server how it signs people in and marks what it finds as **Detected**. Leave both as they are:

- **Authentication:** Sign in now
- **OAuth client:** Register automatically

You do not need to add any request headers.

 ![Authentication set to Sign in now and OAuth client set to Register automatically, both marked Detected](https://forum.jointtex.com/uploads/default/original/1X/146658f315a9ba50a67f3273731c0c288ac0c6fb.png)

## Step 4: Connect and sign in

The connector now appears in your list as not connected. Click **Connect**.

 ![The jointtex connector page saying it is not connected yet, with a Connect button](https://forum.jointtex.com/uploads/default/original/1X/78b0904bac0a0692f0c9ab941ec2df40495b57e5.png)

Your browser opens and Claude asks you to confirm that you started this. Click **Continue connecting**.

 ![Claude's browser page asking whether to finish connecting a connector](https://forum.jointtex.com/uploads/default/original/1X/fc1e997781e3c7d5deaee06b698f45365ba0a125.png)

You land on a JointTex page titled “Connect Claude to JointTex”. Sign in if you are not already. The page shows which app is asking and where your browser will be sent afterwards, and lets you choose what the app may do and which projects it may open. Click **Allow**.

## Step 5: Choose when Claude may use each tool

Back in Claude, the connector shows “Connected to jointtex” and lists its tools in two groups.

 ![The connected jointtex connector with its tool permissions, split into read-only and write/delete tools](https://forum.jointtex.com/uploads/default/original/1X/e515f91d981b91e900234589ca7fa9b484ca52ee.jpeg)

**Read-only tools (8):** list your projects, get a project’s context, list files, read a file, search files, read comments, read tracked changes, and get the compiled PDF.

**Write/delete tools (15):** create, replace, edit, rename, copy, move and delete files and folders; compile the project and change its compile settings; add, reply to, resolve and delete comment threads.

Every tool starts at **Needs approval** , so Claude asks before each call. A setup that works well: set the read-only group to always allowed so Claude can look around without interrupting you, and leave the write/delete group on approval.

## Things to try

Start a new conversation and ask in plain language:

- “List my JointTex projects.”
- “In my thesis project, read the introduction and point out claims that have no citation.”
- “Compile the project and fix the errors in the log.”
- “Read the open comments in `methods.tex` and reply to each one with a proposed change.”
- “Give me a link to the compiled PDF.”

## Good to know

- **It is the same project your coauthors see.** Claude’s edits land in the live document, and its comments appear in the same threads as everyone else’s.
- **Compile settings are shared.** The root file, engine and TeX Live version belong to the project, so a change there affects every collaborator’s compile. Claude is told to change them only when you ask or the build needs it, and to say what it changed.
- **PDF links expire.** A link from “Get the compiled PDF” works for ten minutes and needs no sign-in, so treat it like the PDF itself and ask for a fresh one when you need it again.
- **Usage.** Claude’s side of the conversation counts against your Claude plan, not your JointTex AI allowance. Compiles count toward your normal JointTex compile limit.
- **A comment thread Claude started is one it can delete.** It cannot delete threads other people started; it can only resolve them.

## Changing or removing access

In JointTex, open **Account settings → Access tokens**. Claude is listed under **Connected apps** , where you can narrow what it may do, change which projects it can open, or disconnect it. A disconnected app loses access immediately. A connection that goes unused for 30 days ends by itself, and you sign in again to bring it back.

You can also click **Disconnect** on the connector’s page in Claude.

## Other apps

Any app that accepts an MCP server URL can connect the same way, with the same address. For clients that send a header instead of signing in, create an MCP token on the same Access tokens page.

Questions or something not working? Reply below.

---

<div class="post-metadata">

**Author:** ![JointTex\_Admin](https://forum.jointtex.com/user_avatar/forum.jointtex.com/jointtex_admin/32/12_2.png) [@JointTex\_Admin](https://forum.jointtex.com/u/JointTex_Admin)\
**Post date:** [November 4, 2026, 2:55am UTC](https://forum.jointtex.com/t/connect-claude-to-your-jointtex-projects/13/2 "2026-11-04T02:55:34Z")

</div>

## Connect from Claude Code (command line)

Claude Code connects to JointTex with a single command. There are two ways to sign in.

### Option 1: Sign in with your browser (recommended)

Add JointTex as an MCP server:

```
claude mcp add --transport http --scope user jointtex https://jointtex.com/mcp

```

`--scope user` makes JointTex available in every folder. Leave it out to add it only to the current project.

Then start Claude Code, type `/mcp`, choose **jointtex** and pick **Authenticate**. Your browser opens JointTex. Choose which projects Claude Code can use and what it may do there, then approve. Back in the terminal, JointTex shows as connected.

### Option 2: Use an MCP token (no browser, for servers, SSH and CI)

1. In JointTex, open **Settings → Agent apps (MCP) → Use an MCP token**. Create a token, choose its projects and permissions, and copy it. The token is shown only once.

2. Add the server with the token:

Keep the token private: anyone who has it can work in the projects you chose. You can revoke it from the same settings page at any time.

### Check the connection

```
claude mcp list

```

`jointtex` should show as connected. Try asking Claude Code: _“List my JointTex projects.”_

To remove the connection:

```
claude mcp remove jointtex

```
