mcpwingBack to home
Docs

MCPWing Connector for Claude

Drive the MCPWing platform from Claude — manage projects, MCP deployments, tickets, and designs.

1. What the Wing connector does

MCPWing (Wing) is a remote connector that lets Claude operate your MCPWing organization directly. From a Claude conversation you can manage projects and sub-projects, deploy and inspect MCP servers, work tickets, and read and create designs — all scoped to the organization you authorize and isolated by Postgres Row-Level Security.

The connector is served over Streamable HTTP at https://api.mcpwing.com/wing and authorizes with OAuth 2.0 using Dynamic Client Registration (DCR) and PKCE (S256).

2. Setup

  • In Claude, add a custom connector with the URL https://api.mcpwing.com/wing.
  • Complete the OAuth sign-in flow when Claude prompts you.
  • Select the organization you want Claude to act on.
  • Review and grant the requested scopes (see below).

Once connected, the connector's tools become available to Claude and you can start prompting.

3. Permissions & scopes

The connector requests the following OAuth scopes:

org:readRead your organization and its members.
projects:readList and read projects, sub-projects, and their context.
projects:writeCreate and update projects, designs, and design content.
mcp:readRead MCP deploy status, versions, and recent invocations.
mcp:writeUpload MCP collections, deploy versions, and customize tools.
mcp:keysMint, list, and revoke MCP API keys.
tickets:readList and read tickets and ticket context.
tickets:writeUpdate tickets and post comments on them.

4. Tools reference

The connector exposes 31 tools, grouped by area. Each is marked R (read), W (write), or D (destructive).

Organization

  • R
    whoamiReturn the identity of the authenticated user.
  • R
    get_current_orgReturn the currently selected organization.
  • R
    list_org_membersList members of the current organization.

Projects

  • R
    list_projectsList projects in the organization.
  • R
    list_subprojectsList sub-projects under a project.
  • R
    get_projectGet a single project's details.
  • W
    create_projectCreate a new project.
  • W
    update_projectUpdate an existing project.
  • D
    delete_projectDelete a project and its contents.

MCP deploy

  • R
    get_mcp_statusGet the deploy status of an MCP project.
  • R
    list_mcp_versionsList MCP collection versions for a project.
  • W
    upload_mcp_collectionUpload a new MCP collection version.
  • W
    deploy_mcp_versionDeploy a specific MCP collection version.
  • W
    update_tool_customizationCustomize a tool's configuration.
  • R
    list_recent_invocationsList recent MCP tool invocations.

Tickets

  • R
    list_project_ticketsList tickets for a project.
  • R
    get_ticketGet a single ticket's details.
  • W
    update_ticketUpdate a ticket's fields or status.
  • W
    comment_on_ticketAdd a comment to a ticket.

API keys

  • W
    mint_mcp_api_keyMint a new MCP API key.
  • R
    list_mcp_api_keysList existing MCP API keys.
  • D
    revoke_mcp_api_keyRevoke an MCP API key.

Context engine

  • R
    get_project_contextGet a project's brief, designs, and context.
  • R
    get_design_systemGet the design system for a project.
  • R
    get_designGet a single design.
  • R
    get_ticket_contextGet the full context around a ticket.
  • R
    get_skillGet a skill definition.
  • R
    findSearch across organization content.

Designs

  • R
    get_design_guidelinesGet the guidelines for creating designs.
  • W
    create_designCreate a new design.
  • D
    replace_designReplace an existing design's contents.

5. Example prompts

  • "List my projects, then show me the full context for a project — its brief, designs, and open tickets."
  • "Create a ticket on a sub-project, then comment on it summarizing the design system."
  • "Show the MCP deploy status for my MCP project and list its recent tool invocations."

6. Troubleshooting & support

  • Authorization fails or loops — remove and re-add the connector, then complete the OAuth sign-in again and re-select your organization.
  • A tool returns "forbidden" — the connection may be missing the required scope. Re-authorize and grant the scope listed for that tool in the table above.
  • Wrong organization — disconnect and reconnect to choose a different organization during sign-in.

Need help? Contact hello@mcpwing.com.