Syntra

Project management for teams and project offices. Claude, ChatGPT or Claude Code read and update projects, tasks, risks, sprints and meeting notes with the same permissions as the user who connected it. Remote server, OAuth 2.1; write tools are opt-in per workspace and risky actions ask for confirmation.

托管 MCP 服务器

npx add-mcp 'https://syntra.tymko.tech/mcp'

可安装到 Claude Code、Codex、Cursor 等客户端

文档

Requirements

  • A Syntra account that is a member of a workspace on a paid plan (Start, Team or Business) or in the 14-day Business trial. Reading and writing through Claude and ChatGPT come with every plan; the API and webhooks come with the Business plan. A new workspace starts with 14 days of Business, so you can connect right away. See pricing.
  • Claude (any plan that supports connectors) or ChatGPT (a plan that lets you add a custom MCP server).
  • Nothing to install, no OAuth app to register, no client ID or API key to create. You sign in to Syntra in your browser, pick the workspace and approve access once.

Server address: https://syntra.tymko.tech/mcp. You choose the workspace on the consent page when you connect. If you belong to several workspaces and prefer a separate connector for each, you can use a workspace’s own address instead, https://syntra.tymko.tech/mcp/<workspace>, shown in Syntra on the workspace’s API page. This is optional.

Connect in Claude

Syntra is listed in the Claude Connectors Directory as a community connector. Claude identifies itself to Syntra automatically with a Client ID Metadata Document, so there is no OAuth app, client ID or API key to set up. The connector works in Claude on the web, in Claude Desktop and in the mobile apps.

  1. **Find Syntra.**In Claude, open Customize (or Settings) → Connectors, search for Syntra and click Connect. You can also open the Syntra listing directly.
  2. **Sign in to Syntra.**A Syntra window opens; sign in with your Syntra account (and your second factor, if it is on).
  3. **Pick the workspace and allow access.**The consent page shows the app (Claude, claude.ai), your user, the access level and where you will be sent back. If you belong to several workspaces, choose one, then click Allow.
  4. **Ask.**In a new chat, ask about your projects. Claude calls the Syntra tools and shows each call it makes.

Claude Code connects the same way: claude mcp add --transport http syntra https://syntra.tymko.tech/mcp, then run /mcp to sign in.

Connect in ChatGPT

  1. **Add a custom MCP server.**In ChatGPT, open Plugins (Settings → Apps), click Add, then Add custom MCP server. Enter the URL https://syntra.tymko.tech/mcp and choose OAuth as the authentication.
  2. **Sign in and allow.**ChatGPT identifies itself automatically, so there is nothing to register in Syntra. Sign in to Syntra, pick the workspace and click Allow on the same consent page as for Claude; it names the app as ChatGPT (chatgpt.com).
  3. **Use it in a chat.**Mention Syntra or pick it from the tools menu, then ask your question.

Syntra is not in the ChatGPT app directory yet, so for now it is added as a custom MCP server.

Other MCP clients

Other clients that support remote MCP servers connect to https://syntra.tymko.tech/mcp with OAuth through an OAuth app registered in the workspace settings on the API tab: the same sign-in and consent page as above. Clients that send their own headers can use a Syntra access key instead, as Authorization: Bearer syn_…. For example, Claude Code with a key: claude mcp add --transport http syntra https://syntra.tymko.tech/mcp --header "Authorization: Bearer syn_…". Workspace owners and admins issue keys in the workspace settings on the API tab; every member can create a personal key under Settings → API keys. OAuth apps and access keys come with the Business plan.

Tools

Every connection gets the read tools. The write tools appear on every plan when the workspace has writing switched on and you allowed “read and write” on the consent page. No tool can delete anything.

ToolWhat it does
list_projectsProjects you can see: code, name, status, progress, priority, quarter, leader, deadline, department, health lights, open risks. Read only.
get_projectOne project in full: description, budget, health lights, tasks per status, the tasks themselves and the risks with their mitigation. Read only.
list_tasksTasks across your projects or in one project, newest changes first, filtered by project, status, assignee, sprint or date of change. Read only.
get_taskOne task in full: the whole description, the checklist and the latest comments. Read only.
list_sprintsSprints per department with dates, status, task counts and Story Points. Read only.
get_sprintOne sprint in full: goal, Story Points, its tasks and the burndown. Read only.
whoamiWhich user and workspace the connection acts as, and the role. Read only.
create_taskCreates a task or a bug report in a project, as you. Write.
update_taskChanges a task: title, description, status, assignee, deadline, tags, Story Points, sprint. Write.
add_task_commentAdds a comment to a task; the assignee and project leader are notified. Write.
add_checklist_itemsAdds steps to a task’s checklist, some already ticked if you like. Write.
set_checklist_itemTicks or unticks one checklist step, or renames it. Write.
create_projectCreates a project with a description, status, priority, quarter, deadline and leader. Write.
update_projectChanges a project’s fields, health lights or budget. Write.
add_riskRegisters a risk on a project with its severity and mitigation. Write.
update_riskChanges a risk’s text, severity, mitigation or status (close or reopen). Write.
create_sprintPlans a new sprint for a department. Write.
update_sprintChanges a planned or active sprint’s name, goal or dates. Write.

Example prompts

  • “Which projects are behind schedule this quarter, and why?”
  • “What changed in the marketing projects since Monday?”
  • “How is the current sprint going? Show the burndown and what is still open.”
  • “Who has the most overdue tasks right now?”
  • “Create a bug in project P-117: the checkout button does nothing on iOS, with steps to reproduce.”
  • “Add a high risk to P-131: the supplier may miss the launch date; mitigation: a second supplier.”

Permissions

  • Your rights, nothing more. The assistant acts as you inside the chosen workspace and sees exactly what your role allows; restricted projects stay hidden if you cannot open them.
  • Read for every member. Members of workspaces on any paid plan (Start, Team or Business) or in the 14-day Business trial can connect and read.
  • Writing on every plan, when both allow it. The write tools work on every paid plan (Start, Team or Business) where a Syntra superadmin has switched MCP writing on for the workspace (the owner asks support) and you chose “read and write” on the consent page. Otherwise the connection is read only, whatever the assistant asks for.
  • No deletions. No tool deletes projects, tasks, risks, sprints or comments.
  • Connector only. Tokens issued to Claude and ChatGPT work only for the MCP connection, not for the rest of the Syntra API.
  • Visible changes. Changes made through the connector appear in Syntra under your name, in the task and project history and in the audit log.

Disconnect

Remove the connector in Claude or ChatGPT, and withdraw the consent in Syntra under Settings → API keys → My consents. Every member does this for their own access. After that the assistant’s refresh token stops working at once, and the current access token expires within 24 hours. A workspace owner can also ask support to switch writing off for the whole workspace.

Troubleshooting

“There is no workspace you can connect this app to”

None of your workspaces is on a paid plan, or the workspace address in the connector URL is one you are not a member of. Ask the workspace owner, or connect with the general address https://syntra.tymko.tech/mcp.

The assistant says the connection is read only

Writing is off for the workspace, or you allowed read only. Ask the owner to have writing switched on, then disconnect and connect again and choose “read and write” on the consent page.

A project is missing from the answers

Ask the assistant to run whoami: it shows the user, workspace and role the connection uses. Projects you cannot open in Syntra are not visible to the assistant either.

Support

Write to support@tymko.tech with the time of the problem and, if possible, the tool name the assistant showed.