Skip to content
Guides
/
Synqly MCP

Synqly MCP Integration Guide: Security Integrations with AI

The Synqly MCP (Model Context Protocol) service enables AI agents to interact directly with the Synqly integration platform. It allows users to connect AI agents to security and ITOps services without writing code. This guide will walk you through the process of setting up the MCP integration and using it with Cursor or Claude Desktop.

Overview

The Synqly MCP server supports the following use cases:

  • Integration management: create and update integrations. This could replace a traditional UI for integration configuration with a chatbot.
  • Query or interact with integrations in any Connector. This can be used within a customer-facing chatbot or by an autonomous agent; for example, to make ad-hoc queries to a security product for enrichment or additional context.

Example Queries

  • "What integrations does Synqly support?"
  • "What fields should I provide for the integration to Okta?"
  • "Create a new integration to Okta in the account 'acme-inc'"
  • "List integrations in the account 'acme-inc'"
  • "Query audit logs for the account 'acme-inc'"
  • "What filters are available for querying audit logs?"

Prerequisites

Before setting up the MCP integration, you'll need:

  1. Synqly Organization Token: This is used for authentication.
  2. A client that supports the MCP protocol such as Cursor or Claude Desktop.

Authentication

First you need a Synqly organization token. You can get a global administrator token from the Synqly UI; however, you may want to use the API to create an organization token that is scoped to a specific account so that the MCP server can only access that account.

The create token API supports this, for example:

curl -i -X POST \
  https://api.synqly.com/v1/tokens \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "resources": {
      "accounts": {
        "ids": ["account-to-access"]
      }
    },
    "permission_set": "administrator"
  }'

For production use, we highly recommend only giving an agent access to a single account at a time using account-scoped tokens like the above example. This guarantees that your agent will not be able to mix customer data.

Client Setup

The Synqly MCP server runs at https://mcp.synqly.com/mcp/. It requires an Authorization header with a Synqly organization token as the bearer token. The examples below describe how to configure popular MCP clients.

Cursor

To configure, navigate to Settings -> Cursor Settings -> Tools & Integrations and click on "Add a Custom MCP Server".

Use the following JSON configuration:

{
  "mcpServers": {
    "synqly": {
      "url": "https://mcp.synqly.com/mcp/",
      "headers": {
        "Authorization": "Bearer {org_token}",
      }
    }
  }
}

where {org_token} is the organization token you created above.

Claude Desktop

To configure, navigate to Settings -> Developer and click on "Edit Config".

Use the following JSON configuration:

{
  "mcpServers": {
    "synqly": {
        "command": "npx",
        "args": [
          "-y",
          "supergateway@latest",
          "--streamableHttp",
          "https://mcp.synqly.com/mcp/",
          "--header",
          "Authorization: Bearer {org_token}"
      ]
    }
  }
}
Previous page
Next page