Skip to content

Your connection guide

Add trulyform
to Claude Code.

One command in your terminal and one sign-in in your browser. After that, Claude Code can create and read your forms while you work on your project.

Before you start

What you need

  • Claude Code installed and signed in, with a terminal open in any folder.
  • A trulyform account. You can create one when your browser opens to sign in.
  • If your company manages Claude Code, its settings can allow or block MCP servers. Your admin can tell you which.

MCP is included on trulyform Free. There’s no API key to create or paste into your shell.

Step 1

Add the server from your terminal

Run this once, from any folder:

Claude Code installation command

claude mcp add --transport http --scope user trulyform 'https://trulyform.com/mcp'

Select the text to copy it.

Claude Code prints an Added line when the configuration is saved.

Which scope to choose

  • --scope user, as above, loads trulyform in all your projects. It lives in ~/.claude.json and stays private to you.
  • Leave the scope out to keep trulyform to the current project only.
  • --scope project writes it to .mcp.json so teammates get it from version control. Claude Code asks each person to approve project servers, and everyone signs in with their own trulyform account.

Now run claude mcp list. trulyform shows ! Needs authentication until you sign in. That’s expected.

Step 2

Authenticate with /mcp

  1. Start a session with claude and type /mcp.
  2. Select trulyform, press Enter, and choose Authenticate. Your browser opens trulyform’s sign-in page.
  3. Log in, or choose Sign up. A new account verifies its email first; open the link in the same browser.
  4. On the approval screen, the return address is on your own machine: http://localhost:PORT/callback, with a port Claude Code picks. Check your email and organization, then choose Approve access.
  5. Back in the terminal, trulyform is connected.

Rather stay in your shell? claude mcp login trulyform runs the same sign-in. Over SSH, or anywhere without a browser, it prints a link to open on another device. After you approve, copy the full address from that browser’s address bar and paste it back at the prompt. Connect with ssh -t so the prompt can take the paste.

What you’re approving

Read access to forms and responses across your current organization, plus creating forms, editing drafts, and publishing. This includes teammates’ forms; there is no read-only or per-form selection. Requested data is shared with the assistant under its policies.

Step 3

Make sure you’re connected

From your shell, claude mcp list should now show ✔ Connected next to trulyform. Inside a session, /mcp shows its tool count: ten.

Then ask Claude for something only your account knows:

Connection check prompt

List my trulyform forms.

Select the text to copy it.

The first time, Claude Code may ask permission to use the tool. Approve it. The tool call is labeled with the trulyform server name, which tells you the answer came from your account. A new account has no forms yet, so an empty list is fine.

Step 4

Try it on the project you’re shipping

Claude Code can read your repository, so the form it writes can ask about the work you’re actually shipping. From your project folder, try:

Your first form prompt

Read the README and the latest changes in this repository. Then create a trulyform feedback form for people trying this release: which new features they used, a 1 to 5 rating, what got in their way, and an optional email. Save it as a draft. Don't publish it.

Select the text to copy it.

Open the draft in trulyform and change anything you like. When it’s ready:

Publish prompt

I've reviewed the release feedback form in trulyform. Read its latest draft and publish that revision. Then add its public link to the README under a Feedback heading.

Select the text to copy it.

publish_form needs the revision you reviewed. If the draft has changed since Claude last read it, trulyform rejects the publish until Claude reads the latest draft.

Sign out or remove trulyform

  • In /mcp, select trulyform and choose Clear authentication to remove the sign-in Claude Code stored. claude mcp logout trulyform does the same from your shell.
  • claude mcp remove trulyform removes the server, with the sign-in and client registration Claude Code kept for it.
  • To end access on our side too, open Settings → AI connections in trulyform and choose Revoke access for the Claude Code connection.

Revoking stops future requests. It doesn’t remove anything Claude Code has already received.

Manage AI connections

When Claude Code can’t connect

The browser didn’t open, or showed an error after I approved.

If no browser opens, copy the link Claude Code shows and open it yourself. If the page fails to load after you approve, copy the full address from the browser’s address bar and paste it into the prompt in Claude Code.

/mcp says No MCP servers configured.

The server was probably added in another folder with the default local scope, which ties it to that project. Run the command above again; --scope user makes it load everywhere.

Claude Code says the server isn’t allowed by enterprise policy.

Your organization limits which MCP servers Claude Code may use. The message reads Cannot add MCP server "trulyform": not allowed by enterprise policy. Ask your admin to allow trulyform’s server URL.

trulyform needs authentication again.

Open /mcp, select trulyform, and choose Re-authenticate. This happens after access is revoked in trulyform, or when the connection goes unused for 30 days.

Claude Code documentation

We checked these steps against the pages below on October 3, 2026. Claude Code updates its screens from time to time, so its own documentation is the final word.

Still need a hand? Contact us.

Connected?
Keep the ideas coming.

A clearer question, a better draft, a fresh look at your feedback. There’s a lot you can ask.

Explore what’s possible