Skip to main content
This guide shows you how to create custom connectors for WRITER Agent. Custom connectors enable integration with internal tools and third-party services not available in the prebuilt connector library. You can create custom connectors in two ways:
  • OpenAPI specification: Upload an OpenAPI definition to expose your API endpoints as tools for WRITER Agent.
  • MCP server: Connect to an external MCP server to make its tools available in WRITER Agent.

​
Create a custom connector from an OpenAPI specification

​
Prerequisites

Before creating an OpenAPI-based custom connector, make sure you have:
  • An OpenAPI definition that describes your API
  • Authentication details for your API, based on the authentication method you choose:
    • API key: Key name and optional key prefix
    • OAuth: Authorization server URL, access token URL, refresh token URL, and token endpoint authentication method

​
Set up the connector

Create a custom connector in AI Studio under Connectors & Tools.
  1. Navigate to Connectors & Tools in AI Studio
  2. Select Create custom connector
  3. Choose OpenAPI specification as the connector type
  4. Upload your OpenAPI specification file (JSON or YAML format)
  5. Enter a Connector name and About this connector description
  6. Configure authentication:
    • API key: Enter the key name and optional key prefix
    • OAuth: Enter your OAuth credentials (authorization server URL, access token URL, refresh token URL, and token endpoint authentication method)
  7. Select Next to proceed to tool configuration

​
Configure tools

After uploading your OpenAPI specification, the tool configuration screen lets you review and edit the operations defined in your specification. For each tool, you can:
  • Edit the tool description: Double-click or select the pencil icon to modify the description. Clear descriptions help WRITER Agent understand when to use each tool.
  • Set the operation type: Specify whether the tool performs a read, write, update, or delete operation.
  • Update the tool name: Customize the name that appears in WRITER Agent.
The Usage column shows an estimated token count for each tool, including the tool name, description, and parameters. Use this to identify high-cost tools and reduce token usage. After configuring your tools, select Save to create the connector.

​
Configure the connector in AI Studio

After creating an OpenAPI-based custom connector, configure it for your organization:
  1. Navigate to Connectors & Tools in AI Studio
  2. Find your custom connector and select Configure
  3. Select who has access by default (all users or specific teams)
  4. Select which tools to enable
  5. Enter your API key or OAuth credentials, depending on the authentication method configured for the connector
After configuration, the connector appears in your connected integrations and is available to authorized users in WRITER Agent.

​
Create a custom connector from an MCP server

Connect to an external MCP server to make its tools available in WRITER Agent. The MCP server connector supports three authentication methods:
  • No auth: Connect without authentication.
  • API key: Authenticate with an API key.
  • OAuth: Authenticate with OAuth 2.0, at the user level or org level.

​
Create the connector

  1. Navigate to Connectors & Tools in AI Studio
  2. Select Create custom connector
  3. Choose MCP server as the connector type
  4. Enter the MCP server URL
  5. Enter a Connector name and About this connector description
  6. Select Next to proceed to configuring the connector in AI Studio

​
Configure the connector in AI Studio

After entering your MCP server details, the configure step lets you set up access control and authentication:
  1. Update the Profile name or keep the default
  2. Select who has access by default (all teams or specific teams)
  3. Select the authentication method for the MCP server:
    • No auth: No credentials required. Select Next to complete the connection.
    • API key: Enter the API key details to authenticate with the server.
    • OAuth: Enter your OAuth credentials, including scopes, client ID, and client secret. Select whether authentication is at the user level (each user authenticates individually) or org level (shared connection for the organization).
  4. Complete the connection flow
After configuration, the connector appears in your connected integrations and is available to authorized users in WRITER Agent.

​
Edit a custom connector

Modify an existing custom connector to update its name, description, or tool configurations.
  1. Navigate to Connectors & Tools in AI Studio
  2. Find your custom connector and select Edit connector
  3. Update the connector name or description as needed
  4. Select Next to modify tool configurations:
    • Edit tool descriptions
    • Update operation types
    • Modify tool names
  5. Select Save to apply your changes
When editing a custom connector, you cannot change the connector type (OpenAPI specification or MCP server), the uploaded specification, or the authentication type. To use a different specification or connector type, create a new custom connector.

​
Delete a custom connector

Deleting a custom connector removes it from your organization’s library and disconnects all users.
  1. Navigate to Connectors & Tools in AI Studio
  2. Find your custom connector and select Edit connector (under the three vertical dots)
  3. Select Delete connector
  4. Confirm the deletion
Deleting a custom connector removes it from your library and disconnects all users. This action cannot be undone.

​
Next steps