Claude Connector
Swagger Claude Connector allows Claude to work with your Swagger APIs and documentation so you can search, validate, fix, and publish them using natural-language prompts. This topic explains what Swagger Claude Connector is, how to set up the connection, how to control tool permissions, and how to work with your APIs through Claude.
Swagger Claude Connector is a remote Model Context Protocol (MCP) server that SmartBear hosts, so you can connect to Claude without running or maintaining a server yourself. It exposes 23 Swagger tools to Claude, such as searching your API library, retrieving an API definition, scanning an API against governance rules, and creating portal documentation. It supports both read and write actions.
Swagger Claude Connector is published in Claude's connector directory, where it is listed as Swagger. It enables a sign-in through OAuth 2.0.
Note
Swagger Claude Connector supports cloud-hosted servers only. Claude Code supports both the hosted connector and a local server.
Prerequisites for Swagger Claude Connector
A SmartBear account with access to the Swagger APIs and documentation you want to work with.
A Claude account. To add a connector for an organization, you must be an organization owner.
For a local setup in Claude Code, a working Claude Code installation.
Set up Swagger Claude Connector
To connect your Claude account with Swagger Claude Connector, do the following:
Open the Claude desktop app, and select Customize.
Click Connect your apps.
In the Search connectors field, enter Swagger.
Select the Swagger connector and then click Connect.
You are redirected to the SmartBear sign-in page in your browser.
Sign in with your SmartBear credentials and approve the requested access.
When prompted, select Open Claude to return to the app.
Swagger appears in Claude's Connectors list.
Set Swagger Claude Connector tool permissions
After you connect, set when Claude can use each tool. To set Swagger Claude Connector's permissions, do the following:
On the Customize page, click Connectors.
Select Swagger.
In the Tool permissions section, set the type of permission for each tool. By default, tools require approval before each use.
Note
You only see the tools that your organization has given you access to.
Work with Swagger Claude Connector
After setting up the connector, ask Claude to work with your APIs in plain language. Claude selects the tools it needs and asks for your approval before running any tool that requires it. For example, you can enter a request such as:
Find the train-booking-api in the swaggerclaudeconnect organization, validate it against governance rules, fix any issues, and save it as a new version.
For this request, Claude uses tools such as Swagger: Search APIs and Domains to locate the API, Swagger: Get API Definition to retrieve it, Swagger: Scan API Standardization to check it against governance rules, and Swagger: Standardize API to apply fixes and save a new version.
Swagger Claude Connector FAQ and troubleshooting
Do I need to install or host a server to use Swagger Claude Connector?
No. Swagger Claude Connector is a remote MCP server that SmartBear hosts. You connect through Claude's connector directory without running or maintaining a server yourself.
Does Swagger Claude Connector work with self-hosted servers?
No. Swagger Claude Connector supports cloud-hosted servers only. To work with a local server, use the Swagger MCP Server in Claude Code.
Why does Claude ask for approval before running a tool?
By default, all tools require approval before each use. To change this, set the type of permission for each tool in the Tool permissions section.
Why do I not see all Swagger tools in Claude?
You only see the tools that your organization has given you access to. If a tool you need is missing, contact your organization administrator.
The sign-in fails or Claude does not connect. What should I check?
Make sure that you sign in with your SmartBear credentials and approve the requested access on the SmartBear sign-in page. If you are adding the connector for an organization, verify that you are an organization owner.