Agent connections

Manage your CLI and MCP connections and their authorized workspaces. Each request targets an explicit project. Connections expire after 30 days.

This guide is public. Sign in to view your connections and manage their access.

GETTING STARTED

Your agent, connected to your projects.

Connect your agent to TanDraft to find your projects and build their knowledge.

Which method should I choose?

MCP connects your AI application. CLI + skill suits an agent working in your terminal.

MCP

Your agent accesses TanDraft tools directly from the conversation.

Advantages and limitations
Advantages
  • No TanDraft CLI or skill to install.
  • Connect from your usual AI application.
Limitations
  • Requires an application that supports MCP and its secure sign-in.
  • To analyze code, your agent needs file access.

Skill + CLI

A terminal program, paired with a guide that teaches your agent how to use it.

Advantages and limitations
Advantages
  • Works with a terminal-capable agent, without MCP.
  • Remembers the TanDraft project linked to each code folder.
Limitations
  • Requires installing the CLI and skill.
  • Your agent must be able to follow the skill and run commands.

You only need one method. With either option, your agent sends the results for you; you control access and review its proposals.

TanDraft tools inside your agent

Connect your AI application to tandraft.com, then authorize the workspaces it can access.

What your agent can do today

  • Find your workspaces, projects and their knowledge.
  • Create a project with your permission and link a repository.
  • Publish a source-backed analysis for you to review and validate in TanDraft.
  1. Add TanDraft to your MCP client

    Add this address in your AI application.

    MCP URL
    https://tandraft.com/mcp

    Run these commands, authorize access in your browser, then reload your Codex session.

    Terminal · Codex
    codex mcp add tandraft --url https://tandraft.com/mcp
    codex mcp login tandraft
    Official client documentation
  2. Sign in and choose your workspaces

    Sign in to TanDraft in the browser that opens. Choose the accessible workspaces, then return to your agent.

  3. Try your connection

    First request
    Use TanDraft to list my authorized workspaces, then list the projects in the workspace I choose.

    Your agent should find your actual workspaces. This first request does not change any data.

    Next: analyze an existing repository

    Ask an agent that can read your code for a source-backed analysis. You can review and approve it in TanDraft.

    Message to your agent
    Use TanDraft to analyze this repository and publish source-backed project knowledge. List my authorized workspaces and projects, then ask me to choose the destination if needed.

    Find the results in your project knowledge.

Boards & tickets

Enable Boards in the access settings of your connection. Ask your agent to list boards, read a board, create tickets or move work forward. The MCP and CLI use the same permissions and history.

Boards & tickets
In the Product board, create a ticket for the new onboarding and move it to In progress.

Frequently asked questions

Do I need the CLI or a skill?

No. MCP gives your agent the TanDraft tools directly. CLI + skill is an alternative, not an extra step.

What if I work across several workspaces?

Choose multiple workspaces when connecting, then name the project in your requests. You can edit access or revoke the connection on this page.

A connection problem?

Check that your client uses https://tandraft.com/mcp. If access has expired or been revoked, reconnect TanDraft from your client. For a missing workspace, check the connection’s access on this page.

Your agent performs the analysis when you ask. The connection alone does not launch background tasks.