From 8887fa3bad04568c6f59c3d9c2f4df8217357bcb Mon Sep 17 00:00:00 2001 From: PranayHaldiya Date: Thu, 12 Nov 2026 13:02:53 +0530 Subject: [PATCH] feat(corsair): PM and CRM skill, and an MCP config Claude's directory accepts Claude's plugin directory now refuses config fields Claude Code doesn't read unless the publisher is a Verified organization; it refused 0.1.5 for that. The Agent Plugins mcp.json needs $schema and type streamable-http, which the directory rejects, so the Claude manifests now declare their servers inline with type http and leave mcp.json to the other clients. Adds a corsair-workspace skill for Corsair's own PM and CRM (actions, lookups, an example script for each), mentions them in corsair-data and corsair-connect-apps, and bumps corsair to 0.1.6 and corsair-sdk to 0.1.2. --- .claude-plugin/marketplace.json | 15 ++++- .cursor-plugin/marketplace.json | 2 +- README.md | 2 +- gemini-extension.json | 2 +- .../corsair-sdk/.claude-plugin/plugin.json | 17 +++++- plugins/corsair-sdk/plugin.json | 10 +++- plugins/corsair/.claude-plugin/plugin.json | 18 ++++-- plugins/corsair/README.md | 5 +- plugins/corsair/plugin.json | 16 ++++-- plugins/corsair/server.json | 2 +- .../skills/corsair-connect-apps/SKILL.md | 2 +- plugins/corsair/skills/corsair-data/SKILL.md | 4 +- .../corsair/skills/corsair-workspace/SKILL.md | 56 +++++++++++++++++++ scripts/check.mjs | 16 +++++- 14 files changed, 141 insertions(+), 26 deletions(-) create mode 100644 plugins/corsair/skills/corsair-workspace/SKILL.md diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json index 9fdbd37..097187c 100644 --- a/.claude-plugin/marketplace.json +++ b/.claude-plugin/marketplace.json @@ -10,16 +10,25 @@ { "name": "corsair", "source": "./plugins/corsair", - "description": "Use your connected apps from your agent: read and act on them, search synced data and set up automations.", + "description": "Work in Corsair from your agent: track issues in its PM, keep contacts and deals in its CRM, search across them and your connected apps, and set up routines.", "category": "productivity", - "tags": ["integrations", "automation", "mcp"] + "tags": [ + "integrations", + "automation", + "mcp" + ] }, { "name": "corsair-sdk", "source": "./plugins/corsair-sdk", "description": "Set up the Corsair SDK in a TypeScript app. Includes the Corsair docs MCP server.", "category": "development", - "tags": ["integrations", "oauth", "webhooks", "sdk"] + "tags": [ + "integrations", + "oauth", + "webhooks", + "sdk" + ] } ] } diff --git a/.cursor-plugin/marketplace.json b/.cursor-plugin/marketplace.json index 17d5473..d53bf56 100644 --- a/.cursor-plugin/marketplace.json +++ b/.cursor-plugin/marketplace.json @@ -11,7 +11,7 @@ { "name": "corsair", "source": "./plugins/corsair", - "description": "Use your connected apps from your agent: read and act on them, search synced data and set up automations.", + "description": "Work in Corsair from your agent: track issues in its PM, keep contacts and deals in its CRM, search across them and your connected apps, and set up routines.", "logo": "https://corsair.dev/corsair-logo.png", "category": "productivity" }, diff --git a/README.md b/README.md index f816182..19fdff8 100644 --- a/README.md +++ b/README.md @@ -4,7 +4,7 @@ Plugins that install [Corsair](https://corsair.dev) into AI clients. One tree se | Plugin | For | Contains | | --- | --- | --- | -| [`corsair`](plugins/corsair) | People using their connected apps from an agent | The Corsair MCP server and five skills for using it | +| [`corsair`](plugins/corsair) | People working in Corsair's PM and CRM, or their connected apps, from an agent | The Corsair MCP server and six skills for using it | | [`corsair-sdk`](plugins/corsair-sdk) | Developers adding the Corsair SDK to an app | The `corsair` setup skill and the Corsair docs MCP server | ## Install diff --git a/gemini-extension.json b/gemini-extension.json index 7f8384d..64ab98f 100644 --- a/gemini-extension.json +++ b/gemini-extension.json @@ -1,6 +1,6 @@ { "name": "corsair", - "version": "0.1.5", + "version": "0.1.6", "description": "Use your connected apps from your agent: read and act on them, search synced data and set up automations.", "mcpServers": { "corsair": { diff --git a/plugins/corsair-sdk/.claude-plugin/plugin.json b/plugins/corsair-sdk/.claude-plugin/plugin.json index 171492f..3fba598 100644 --- a/plugins/corsair-sdk/.claude-plugin/plugin.json +++ b/plugins/corsair-sdk/.claude-plugin/plugin.json @@ -1,6 +1,6 @@ { "name": "corsair-sdk", - "version": "0.1.1", + "version": "0.1.2", "displayName": "Corsair SDK", "description": "Set up the Corsair SDK in a TypeScript app. Includes the Corsair docs MCP server.", "author": { @@ -13,6 +13,17 @@ "license": "Apache-2.0", "privacyPolicyUrl": "https://corsair.dev/privacy-policy", "termsOfServiceUrl": "https://corsair.dev/terms-of-service", - "keywords": ["corsair", "integrations", "oauth", "webhooks", "sdk"], - "mcpServers": "./mcp.json" + "keywords": [ + "corsair", + "integrations", + "oauth", + "webhooks", + "sdk" + ], + "mcpServers": { + "corsair-docs": { + "type": "http", + "url": "https://docs.corsair.dev/mcp" + } + } } diff --git a/plugins/corsair-sdk/plugin.json b/plugins/corsair-sdk/plugin.json index 5ba162f..8a26cac 100644 --- a/plugins/corsair-sdk/plugin.json +++ b/plugins/corsair-sdk/plugin.json @@ -1,7 +1,7 @@ { "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json", "name": "corsair-sdk", - "version": "0.1.1", + "version": "0.1.2", "description": "Set up the Corsair SDK in a TypeScript app. Includes the Corsair docs MCP server.", "author": { "name": "Corsair", @@ -11,7 +11,13 @@ "homepage": "https://docs.corsair.dev", "repository": "https://github.com/corsairdev/agent-plugins", "license": "Apache-2.0", - "keywords": ["corsair", "integrations", "oauth", "webhooks", "sdk"], + "keywords": [ + "corsair", + "integrations", + "oauth", + "webhooks", + "sdk" + ], "extensions": { "com.openai": { "interface": { diff --git a/plugins/corsair/.claude-plugin/plugin.json b/plugins/corsair/.claude-plugin/plugin.json index def1e74..53921a8 100644 --- a/plugins/corsair/.claude-plugin/plugin.json +++ b/plugins/corsair/.claude-plugin/plugin.json @@ -1,9 +1,9 @@ { "name": "corsair", - "version": "0.1.5", + "version": "0.1.6", "displayName": "Corsair", "icon": "./assets/icon.png", - "description": "Use your connected apps from your agent: read and act on them, search synced data and set up automations.", + "description": "Work in Corsair from your agent: track issues in its PM, keep contacts and deals in its CRM, search across them and your connected apps, and set up routines.", "author": { "name": "Corsair", "email": "primary@corsair.dev", @@ -16,6 +16,16 @@ "license": "Apache-2.0", "privacyPolicyUrl": "https://corsair.dev/privacy-policy", "termsOfServiceUrl": "https://corsair.dev/terms-of-service", - "keywords": ["corsair", "integrations", "automation", "mcp"], - "mcpServers": "./mcp.json" + "keywords": [ + "corsair", + "integrations", + "automation", + "mcp" + ], + "mcpServers": { + "corsair": { + "type": "http", + "url": "https://mcp.corsair.dev/mcp" + } + } } diff --git a/plugins/corsair/README.md b/plugins/corsair/README.md index d610f87..4f3dae1 100644 --- a/plugins/corsair/README.md +++ b/plugins/corsair/README.md @@ -1,11 +1,12 @@ # Corsair -Use the apps you've connected in [Corsair](https://corsair.dev) from your agent: read and act on them, search synced data, and set up automations that run on app events or a schedule. +Work in [Corsair](https://corsair.dev) from your agent: track issues in Corsair's PM, keep people, companies and deals in its CRM, use the other apps you've connected, search across all of them, and set up automations that run on app events or a schedule. -The plugin adds the Corsair MCP server, `https://mcp.corsair.dev/mcp`, and five skills: +The plugin adds the Corsair MCP server, `https://mcp.corsair.dev/mcp`, and six skills: | Skill | Covers | | --- | --- | +| `corsair-workspace` | Corsair's own PM and CRM: filing and updating issues, and keeping people, companies, deals, notes and tasks | | `corsair-connect-apps` | Finding an app, handing over its sign-in link or pointing to the Connect button on Corsair's card, and confirming the connection | | `corsair-data` | When to search synced data, read an app live, make a change or wait on a long job; what apps on Corsair's account cost; when to send Corsair feedback | | `corsair-automations` | Building automations from plain English or exact steps, then checking their runs | diff --git a/plugins/corsair/plugin.json b/plugins/corsair/plugin.json index 6b9ad30..83c0231 100644 --- a/plugins/corsair/plugin.json +++ b/plugins/corsair/plugin.json @@ -1,8 +1,8 @@ { "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json", "name": "corsair", - "version": "0.1.5", - "description": "Use your connected apps from your agent: read and act on them, search synced data and set up automations.", + "version": "0.1.6", + "description": "Work in Corsair from your agent: track issues in its PM, keep contacts and deals in its CRM, search across them and your connected apps, and set up routines.", "author": { "name": "Corsair", "email": "primary@corsair.dev", @@ -11,7 +11,12 @@ "homepage": "https://corsair.dev", "repository": "https://github.com/corsairdev/agent-plugins", "license": "Apache-2.0", - "keywords": ["corsair", "integrations", "automation", "mcp"], + "keywords": [ + "corsair", + "integrations", + "automation", + "mcp" + ], "extensions": { "com.openai": { "onboardingSkill": "./skills/corsair-connect-apps/SKILL.md", @@ -20,7 +25,10 @@ "shortDescription": "Use your connected apps and automate across them", "developerName": "Corsair", "category": "Productivity", - "capabilities": ["Read", "Write"], + "capabilities": [ + "Read", + "Write" + ], "websiteURL": "https://corsair.dev", "privacyPolicyURL": "https://corsair.dev/privacy-policy", "termsOfServiceURL": "https://corsair.dev/terms-of-service", diff --git a/plugins/corsair/server.json b/plugins/corsair/server.json index a49ebbd..0f0becd 100644 --- a/plugins/corsair/server.json +++ b/plugins/corsair/server.json @@ -3,7 +3,7 @@ "name": "dev.corsair/mcp", "title": "Corsair", "description": "Use your connected apps from your agent: search synced data, act in apps and set up automations.", - "version": "0.1.5", + "version": "0.1.6", "websiteUrl": "https://corsair.dev", "repository": { "url": "https://github.com/corsairdev/agent-plugins", diff --git a/plugins/corsair/skills/corsair-connect-apps/SKILL.md b/plugins/corsair/skills/corsair-connect-apps/SKILL.md index 7e2b1b2..b61c96b 100644 --- a/plugins/corsair/skills/corsair-connect-apps/SKILL.md +++ b/plugins/corsair/skills/corsair-connect-apps/SKILL.md @@ -5,7 +5,7 @@ description: Use when the user wants to use an app through Corsair that isn't co # Connect an app through Corsair -Corsair can reach the user's apps (Gmail, Slack, GitHub, Linear and hundreds more). Most need the user to sign in first. Your part is to find the app, get the sign-in link, hand it over, and confirm it worked. You never sign in on the user's behalf. +Corsair's own PM and CRM are ready on every link and need no sign-in (see the corsair-workspace skill). Corsair can also reach the user's other apps (Gmail, Slack, GitHub, Linear and hundreds more); most of those need the user to sign in first. Your part is to find the app, get the sign-in link, hand it over, and confirm it worked. You never sign in on the user's behalf. ## Steps diff --git a/plugins/corsair/skills/corsair-data/SKILL.md b/plugins/corsair/skills/corsair-data/SKILL.md index 474887e..7d82fd1 100644 --- a/plugins/corsair/skills/corsair-data/SKILL.md +++ b/plugins/corsair/skills/corsair-data/SKILL.md @@ -1,6 +1,6 @@ --- name: corsair-data -description: Use when answering a question from the user's connected apps through Corsair (find a message, summarize recent emails, check a calendar, look up an issue) or doing something in an app right now (send, create, update). Explains when to search synced data with search, read live with read_data, make changes with run_script, wait on long jobs with get_job, what apps on Corsair's account cost, and when to send submit_feedback. +description: Use when answering a question from the user's Corsair workspace or connected apps (find a message, summarize recent emails, check a calendar, look up an issue, a deal or a note in Corsair's PM or CRM) or doing something in an app right now (send, create, update). Explains when to search synced data with search, read live with read_data, make changes with run_script, wait on long jobs with get_job, what apps on Corsair's account cost, and when to send submit_feedback. --- # Read and act on connected apps @@ -9,7 +9,7 @@ Three Corsair tools reach the user's data: | | `search` | `read_data` | `run_script` | | --- | --- | --- | --- | -| Reads | Data Corsair has already synced (Slack messages, Gmail, Calendar and so on) | The app's live API | The app's live API | +| Reads | Corsair's own PM and CRM, and data Corsair has already synced from connected apps (Slack messages, Gmail, Calendar and so on) | The app's live API | The app's live API | | Writes | No | No: the script stops at the first write, before that write runs | Yes: send, create, update, delete | | Best for | Finding things ("what did Sarah say about the refund?") | Current state and exact lists | Any change | diff --git a/plugins/corsair/skills/corsair-workspace/SKILL.md b/plugins/corsair/skills/corsair-workspace/SKILL.md new file mode 100644 index 0000000..fe2ce5b --- /dev/null +++ b/plugins/corsair/skills/corsair-workspace/SKILL.md @@ -0,0 +1,56 @@ +--- +name: corsair-workspace +description: Use when the user wants to track work or customers in Corsair: file, update or list issues and projects in Corsair's PM, or add and update people, companies, deals, notes and tasks in Corsair's CRM. Gives the action names and the usual lookups for both. +--- + +# Corsair's PM and CRM + +Every Corsair link comes with two apps of Corsair's own. Their data lives in Corsair, so they work without any other app connected. + +- **PM** (`pm`): teams, projects, issues with a status, priority, assignee, labels and a due date, plus comments. +- **CRM** (`crm`): people, companies and deals. A deal has a stage (Lead, In Progress, Won, Lost), a value, an owner and linked people and company. Any record can have notes and tasks. + +Find what's there with `search` first ("what's open for the Kestrel pilot?" finds the deal, its notes and tasks, and the PM issues that name it). Use `read_data` for complete lists and `run_script` for changes, as the corsair-data skill explains. + +## PM + +| To | Action | +| --- | --- | +| Look up teams, states, people, labels, projects | `pm.db.teams.search`, `pm.db.workflowStates.search`, `pm.db.users.search`, `pm.db.issueLabels.search`, `pm.db.projects.search` | +| List or find issues | `pm.db.issues.search` (filter on `title`, `stateId`, `assigneeId`, `projectId`, `dueDate`) | +| File an issue | `pm.api.issues.create`: `title`, and optionally `stateId`, `priority` (1 urgent, 2 high, 3 medium, 4 low), `assigneeId`, `dueDate` (YYYY-MM-DD), `projectId`, `labelIds` | +| Change an issue | `pm.api.issues.update` with the issue's `id` | +| Comment | `pm.api.comments.create` | + +Ids come from the lookups, never from names: look up the state, label, project and member first, in the same script. + +```js +const [states, labels, projects, users] = await Promise.all([ + corsair.pm.db.workflowStates.search({ limit: 50 }), + corsair.pm.db.issueLabels.search({ limit: 50 }), + corsair.pm.db.projects.search({ limit: 50 }), + corsair.pm.db.users.search({ limit: 50 }), +]); +const todo = states.find((s) => s.name === 'Todo'); +const bug = labels.find((l) => l.name === 'Bug'); +const relaunch = projects.find((p) => p.name === 'Website relaunch'); +return await corsair.pm.api.issues.create({ + title: 'Checkout button does nothing in Safari', + stateId: todo?.id, priority: 1, labelIds: bug ? [bug.id] : [], projectId: relaunch?.id, + assigneeId: users[0]?.id, dueDate: '2026-11-21', +}); +``` + +## CRM + +| To | Action | +| --- | --- | +| Find records | `crm.api.records.query` with `object` (`people`, `companies`, `deals`), and `q` for text or `filter` such as `{ stage: 'Lead' }` | +| Add a record | `crm.api.records.create` with `object` and `values` (attribute slugs from `crm.api.attributes.list`) | +| Change a record | `crm.api.records.patch` with `object`, `record_id`, `values`; a deal's stage takes the stage's title | +| Notes | `crm.api.notes.create` with `record_id`, `title`, `content` | +| Tasks | `crm.api.tasks.create` with `content`, `deadline`, `linked_records` | + +A record's values come back as lists of dated values; the current one has `active_until: null`. + +Moving a deal to Won or Lost, or deleting anything, changes the user's records: say what you'll change and do it only when they asked for it. diff --git a/scripts/check.mjs b/scripts/check.mjs index 381e956..5311364 100644 --- a/scripts/check.mjs +++ b/scripts/check.mjs @@ -70,7 +70,20 @@ for (const { name } of entries.claude) { fail(`${market} marketplace: ${name} description differs from ${dir}/plugin.json`); } } - if (claude.mcpServers !== "./mcp.json") fail(`${dir}/.claude-plugin/plugin.json: mcpServers should be "./mcp.json"`); + // Claude's directory refuses the Agent Plugins MCP file ($schema, type + // streamable-http), so the Claude manifest declares its servers inline with + // type http, one per server in mcp.json, at the same URL. + const portableServers = json(`${dir}/mcp.json`)?.mcpServers ?? {}; + const claudeServers = claude.mcpServers; + if (typeof claudeServers !== "object" || claudeServers === null) { + fail(`${dir}/.claude-plugin/plugin.json: mcpServers should be an inline object`); + } else { + for (const [name, server] of Object.entries(portableServers)) { + const c = claudeServers[name]; + if (!c || c.type !== "http" || c.url !== server.url) fail(`${dir}/.claude-plugin/plugin.json: mcpServers.${name} should be {type: "http", url: "${server.url}"}`); + } + for (const name of Object.keys(claudeServers)) if (!portableServers[name]) fail(`${dir}/.claude-plugin/plugin.json: mcpServers.${name} is not in mcp.json`); + } const openai = portable.extensions?.["com.openai"] ?? {}; for (const rel of [openai.onboardingSkill, openai.interface?.composerIcon, openai.interface?.logo]) { @@ -99,6 +112,7 @@ for (const { name } of entries.claude) { const corsair = json("plugins/corsair/plugin.json"); const urls = { "plugins/corsair/mcp.json": json("plugins/corsair/mcp.json")?.mcpServers?.corsair?.url, + "plugins/corsair/.claude-plugin/plugin.json": json("plugins/corsair/.claude-plugin/plugin.json")?.mcpServers?.corsair?.url, "gemini-extension.json": json("gemini-extension.json")?.mcpServers?.corsair?.httpUrl, "plugins/corsair/server.json": json("plugins/corsair/server.json")?.remotes?.[0]?.url, };