MCP server

Connect to the Repsona MCP server and you can ask AI assistants such as ChatGPT, Claude, Gemini and Copilot to work in Repsona in plain words. Ask "What should I do today?", turn meeting notes into tasks, push back a due date, or spot what is slipping, all from your conversation with the assistant, without opening Repsona.

What is MCP?

MCP (Model Context Protocol) is a common standard that lets AI assistants use outside data and tools. Any assistant that supports MCP connects to Repsona once you add the Repsona MCP server URL.

What you can do

You can ask the assistant to do most of what you do on the Repsona screens. It picks the operations it needs for each request.

• Plan your day: Orders your day from the tasks you are responsible for, the ones where you hold the ball, overdue tasks and your inbox, and adds them to your Today list.
• Find and summarize: Finds tasks and notes by keyword, assignee, status or due date, and summarizes comments and history. Pick a period and it writes a weekly report from what moved and what got done.
• Create and edit tasks: Creates tasks with subtasks and dependencies in one go, with durations in business days (the server skips holidays and regular days off). Changes status, assignee, ball holder and dates, shifts tasks by business days (with the tasks after them), duplicates and deletes.
• Check the plan: Reports overdue tasks, tasks due soon, untouched tasks, dependency conflicts and the critical path (including where it has slack). It also reads workload per person and insights such as burndown.
• Notes and comments: Reads, writes and edits notes, turns minutes into tasks, replies in comments and adds reactions.
• Files: Reads text and images attached to tasks and notes, and attaches files.
• Set up projects: Creates and edits milestones, statuses, tags, templates and Kaizen (KPT) cards. Admins can also create projects, change their settings and add or remove members.

The assistant sees only what the person who connected it can see in Repsona. It cannot manage the space (invitations, roles, IP restriction, billing and so on) or set up integrations.

Connect

In ChatGPT, Claude, Gemini and Copilot, add the URL, sign in to Repsona and approve the assistant. No API key needed.

Each space has its own server URL: the Repsona URL you open in your browser, followed by /api/mcp. It uses HTTP (Streamable HTTP).

https://{space}.repsona.com/api/mcp

One connection reaches one space. To use several spaces, add one connection per space (naming them like "Repsona acme" and "Repsona beta" makes it easy to switch in a conversation).

Claude

Works on the web, desktop and mobile. Add it from the web or the desktop app.

1. Open Settings → Connectors → Add custom connector.
2. Enter Repsona as the name and https://{space}.repsona.com/api/mcp as the URL, then add it.
3. Click Connect, then sign in to Repsona and approve on the page that opens.

Turn Repsona on or off for a chat from + → Connectors in the message box. On Team and Enterprise plans, an organization admin adds the connector first.

ChatGPT

Add it on the web. Developer mode is required (Settings → Apps & Connectors → Advanced settings → Developer mode).

1. Open Settings → Apps & Connectors → Create.
2. Enter Repsona as the name and https://{space}.repsona.com/api/mcp as the MCP server URL, choose OAuth for authentication, and create it.
3. Sign in to Repsona and approve on the page that opens.

To use it in a chat, choose + → Developer mode → Repsona in the message box. On Business and Enterprise plans, a workspace admin allows custom connectors first.

Gemini

Add it on the web (gemini.google.com). Once added, it also works in the Gemini mobile app.

1. Open Settings → Custom apps → Add a custom app.
2. Enter https://{space}.repsona.com/api/mcp as the MCP server URL and add it.
3. Sign in to Repsona and approve on the page that opens.

Check the Gemini help for which accounts and regions can use custom apps.

Microsoft 365 Copilot

Connect Repsona to an agent in Copilot Studio, then publish the agent to Microsoft 365 Copilot and Teams. You need access to Copilot Studio.

1. In Copilot Studio, open the agent and choose Tools → Add a tool → Model Context Protocol.
2. Enter https://{space}.repsona.com/api/mcp as the server URL, choose OAuth 2.0 for authentication, and create it.
3. When you create the connection, sign in to Repsona and approve on the page that opens.
4. Publish the agent to Microsoft 365 Copilot and Teams.

If your organization has a data policy for connectors, an admin allows the Repsona MCP server first.

Other assistants

Assistants that take a URL and headers in a settings file, such as Claude Code, Cursor and Visual Studio Code, authenticate with an API key.

1. In Repsona, go to Personal settings → API key and create an API key.
2. Set the URL to https://{space}.repsona.com/api/mcp and the header to Authorization: Bearer YOUR_API_KEY (replace YOUR_API_KEY with your API key).

Most settings files look like this.

{
  "mcpServers": {
    "repsona": {
      "url": "https://{space}.repsona.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

In Claude Code, run this in the terminal.

claude mcp add --transport http repsona https://{space}.repsona.com/api/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

Settings for any AI assistant

Assistants not listed here can connect too, as long as they support MCP. Enter these values in the fields with similar names.

The OAuth client is registered in one of these ways, depending on the assistant:

• Automatic registration (Client ID Metadata Document, Dynamic Client Registration): Most assistants, including ChatGPT and Claude, register on their own when you add the URL. Nothing to set up.
• Entering a client ID and secret: For assistants with fields for client ID, client secret, authorization URL and token URL, such as Gemini Enterprise and Copilot Studio, a space admin creates a client first.
  1. Find the redirect URL (callback URL) in the assistant's settings.
  2. In Repsona, open Admin settings → AI assistants → Create client, and enter a name and that redirect URL.
  3. Enter the client ID, client secret, authorization URL and token URL shown into the assistant. For scopes, enter read write offline_access (or read offline_access for read-only). The client secret is shown only once.

If it does not connect, check that the URL is your space's (it includes {space}), and that the space has no IP restriction.

Permissions and safety

• The assistant acts with the permissions of the person who connected it. It sees only what you can see in Repsona, and admin-only operations work only when an admin connected it.
• When you approve, you choose read-only or read and write. API keys can also be created as read-only. A read-only connection does not offer the assistant any operation that writes.
• Changes made by the assistant appear in the task or note history under your name, marked as made through an AI assistant.
• Most assistants ask before they delete anything. Deleted tasks and notes cannot be restored, so review before you approve.
• In a space with IP restriction, assistants that call from their provider's servers (ChatGPT, Claude, Gemini, Copilot and so on) cannot connect. Assistants that call from your own machine, such as Claude Code, connect from allowed IP addresses.
• Available on every plan.
• You can revoke access at any time from Personal settings → Connected apps in Repsona. Delete API keys from API key.

Example prompts

You don't need task numbers or tool names. Ask the way you would ask a colleague.

Your day

• "What should I work on today, in order of priority? Add them to my Today list"
• "Show me my overdue tasks and the ones where I hold the ball"
• "What do I need to finish this week?"

Find and summarize

• "Which tasks in the website renewal have been stuck for more than a week?"
• "Read the comments on the pricing page task and split them into what's decided and what's still open"
• "Write a weekly report of last week's progress on the website renewal"

Update

• "Mark the pricing page task as done"
• "Push the design review back 3 business days, and shift the tasks after it too"
• "Create tasks from these meeting notes, with the assignees and due dates they mention"
• "Hand the ball on the launch announcement to Sam and leave a comment asking for a review"

Check the plan

• "What's the critical path for the website renewal, and where is there slack?"
• "Are any tasks likely to miss the Launch milestone?"
• "Is anyone overloaded next week?"
• "What's the most important thing to focus on in this project right now?"

Notes

• "Read the kickoff note and turn the decisions into tasks"
• "Summarize this week's progress on the project and write it into a note"

Set up the project

• "Add a Beta launch milestone due December 20 to this project"
• "Look back at last month in this project for a Kaizen review and add Problem and Try cards"
• "Sort my inbox into what needs action and what is just for information"