Files
PaperClipAI/packages/shared/src/app-definitions/bitly.json
T
DottaandPaperclip fcb2e99e8f feat(apps): expand the self-serve connection catalog (#12344)
## Thinking Path

> - Paperclip is the open source app people use to manage AI agents for
work.
> - A useful app store needs accurate and selectable provider
definitions.
> - Local brand assets now cover the expanded provider set.
> - Provider methods differ in transport, authentication, ownership, and
required scope.
> - This pull request expands the catalog and encodes those provider
contracts.
> - The benefit is a larger self-serve store with explicit setup
choices.

## Linked Issues or Issue Description

Refs #11965

This is stack 6 of 11. It depends on stack 5 and replaces another
reviewable part of #11965.

## What Changed

- Add and update provider definitions for the self-serve catalog.
- Add Google Workspace connection methods and capability profiles.
- Add catalog generation, ingestion, URL matching, and contract tests.
- Update legacy key tests to use a provider that still uses header
credentials.

## Verification

- `pnpm --filter @paperclipai/server typecheck`
- `pnpm --filter @paperclipai/server exec vitest run
src/__tests__/tool-access-service.test.ts`
- Result: 164 tests passed.
- `pnpm build`

## Risks

- An incorrect provider definition can offer the wrong setup method.
- Contract tests verify transport, authentication, and provider URL
behavior.
- The change does not add a database migration.

> I checked `ROADMAP.md`. This stack continues the existing app
connection work from #11965 and does not duplicate another planned item.

## Model Used

OpenAI Codex, GPT-5. The runtime model ID and context window were not
exposed. The model used reasoning, tool use, and code execution.

## Checklist

- [x] I have included a thinking path that traces from project context
to this change
- [x] I have specified the model used (with version and capability
details)
- [x] I have checked ROADMAP.md and confirmed this PR does not duplicate
planned core work
- [x] I have searched GitHub for duplicate or related PRs and linked
them above
- [x] I have either (a) linked existing issues with `Refs #` or (b)
described the issue in this pull request
- [x] I have not referenced internal or instance-local Paperclip issues
or links
- [x] My branch name describes the change and contains no internal
Paperclip ticket id or instance-derived details
- [x] I have run tests locally and they pass
- [x] I have added or updated tests where applicable
- [x] I have updated relevant documentation to reflect my changes
- [x] I have considered and documented any risks above
- [x] All Paperclip CI gates are green
- [x] Greptile is 5/5 with no open P2s, recommendations, or follow-ups
- [x] I will address all Greptile and reviewer comments before
requesting merge

---------

Co-authored-by: Paperclip <noreply@paperclip.ing>
2026-08-29 12:08:34 -05:00

79 lines
2.3 KiB
JSON

{
"schemaVersion": 1,
"slug": "bitly",
"name": "Bitly",
"description": "Connect Bitly's provider-hosted MCP server.",
"categories": [
"analytics"
],
"featured": false,
"branding": {
"logoUrl": "/brands/apps/bitly.svg"
},
"urlPatterns": [
"https://api-ssl.bitly.com/*"
],
"docsUrl": "https://dev.bitly.com/bitly-mcp/overview/quickstart/",
"redirectConstraints": "https-or-loopback-http",
"methods": [
{
"key": "mcp-oauth",
"transport": "mcp_remote",
"auth": "oauth",
"ownershipModes": [
"dcr"
],
"whenToUse": "Use browser sign-in for the provider-hosted MCP server.",
"defaults": {
"serverUrl": "https://api-ssl.bitly.com/v4/mcp"
},
"guidanceMd": "Connect Bitly in the browser. A Bitly account with either browser authorization or an API token.",
"riskTier": "S2",
"label": "Sign in with Bitly",
"consoleLinks": {
"docs": "https://dev.bitly.com/bitly-mcp/overview/quickstart/"
},
"warnings": [
"A Bitly account with either browser authorization or an API token."
]
},
{
"key": "mcp-api-key",
"transport": "mcp_remote",
"auth": "api_key",
"ownershipModes": [
"customer"
],
"whenToUse": "Use a restricted customer-owned key when browser sign-in is not suitable.",
"defaults": {
"serverUrl": "https://api-ssl.bitly.com/v4/mcp"
},
"guidanceMd": "Use a customer-created Bitly key. A Bitly account with either browser authorization or an API token.",
"riskTier": "S2",
"label": "Use an API key",
"credentialFields": [
{
"key": "authorization",
"label": "Bitly API key",
"type": "password",
"required": true,
"placeholder": "Paste your Bitly API token",
"secret": true
}
],
"keyPlacement": {
"location": "header",
"name": "Authorization",
"prefix": "Bearer "
},
"consoleLinks": {
"keys": "https://dev.bitly.com/bitly-mcp/overview/quickstart/",
"docs": "https://dev.bitly.com/bitly-mcp/overview/quickstart/"
},
"warnings": [
"A Bitly account with either browser authorization or an API token."
]
}
]
}