Object Class MCP Connectors

This document describes the API for retrieving the MCP Connectors associated with an Object Class.

An MCP Connector is a registered external client of the MCP server. Object Classes can be associated with a connector so that they are available for permission configuration for the connector. This endpoint lists the connectors associated with a selected Object Class.

ℹ️ In the scope of this story, associating Object Classes with a connector does not affect user access through MCP. That behaviour is a separate, future story.

The endpoint is nested under an Object Class (nested routers) and uses the standard limit/offset pagination, sorting and filtering mechanisms.

Permissions

Endpoint	Permission
GET /api/object-classes/{class_id}/mcp-connectors/	view permission for the Object Class class_id

The caller must have the view permission for the Object Class class_id, either globally on the object_classes resource or per-object. The list permission alone (without view) is not sufficient.

GET /api/object-classes/class_id/mcp-connectors/

Returns the list of MCP Connectors associated with the Object Class.

Permissions

Requires authentication and object_classes.view permission for the Object Class class_id.

URL parameters

Key	Type	Notes
class_id	int	Object Class ID

Request example

• Headers

Request Method: GET
Content-Type: application/json
Authorization: JWT access_token

Response

Key	Type	Notes
limit	int
offset	int
total_count	int	Total number of MCP Connectors associated with the Object Class.
filtered_count	int	Number of associated MCP Connectors with filters applied.
next	URL / null	Next page URL (null if there is no next page)
previous	URL / null	Previous page URL (null if there is no previous page)
results	Array	Described in the next table.

Response results array

Key	Type	Notes
id	int	MCP Connector ID
name	string	MCP Connector name
integration	uuid	Integration ID
_meta.labels.integration	Object	Integration details

Results are sorted by id ascending by default.

Response example

• Status 200 OK
• Body

{
    "limit": 100,
    "offset": 0,
    "filtered_count": 2,
    "total_count": 2,
    "next": null,
    "previous": null,
    "results": [
        {
            "id": 5,
            "name": "Claude connector",
            "integration": "b08cec76-030b-494c-b987-0692a9946892",
            "_meta": {
                "labels": {
                    "integration": {
                        "name": "Claude",
                        "type": "anthropic_claude",
                        "category": "ai_mcp"
                    }
                }
            }
        },
        {
            "id": 16,
            "name": "Claude - analytics",
            "integration": "b08cec76-030b-494c-b987-0692a9946892",
            "_meta": {
                "labels": {
                    "integration": {
                        "name": "Claude",
                        "type": "anthropic_claude",
                        "category": "ai_mcp"
                    }
                }
            }
        }
    ]
}

Sorting

Parameter	Example	Notes
id	{build}/api/object-classes/{class_id}/mcp-connectors/?ordering=id	Ascending
id	{build}/api/object-classes/{class_id}/mcp-connectors/?ordering=-id	Descending (-)
name	{build}/api/object-classes/{class_id}/mcp-connectors/?ordering=name	Ascending
name	{build}/api/object-classes/{class_id}/mcp-connectors/?ordering=-name	Descending (-)

Filtering

Parameter	Predicates	Example
id	standard numeric	{build}/api/object-classes/{class_id}/mcp-connectors/?id__gt=10
name	standard string	{build}/api/object-classes/{class_id}/mcp-connectors/?name__icontains=foo

Standard numeric predicates for id: =, gt, gte, lt, lte, range (e.g. id, id__gt, id__lt, id__range). Standard string predicates for name: =, iexact, contains, icontains, startswith, istartswith, endswith, iendswith (e.g. name, name__icontains, name__istartswith).

Errors

Error	Response code	Message
Not authenticated	401 Unauthorized	"detail": "Authentication credentials were not provided."
Caller lacks view permission for the Object Class	403 Forbidden	"detail": "You do not have permission to perform this action."
class_id does not exist	404 Not Found