KognitaKognita.
Back to Overview

Custom MCP

Custom MCP servers

Custom MCPs let a Kognita project connect to any approved MCP-compatible server. Your agent already has semantic code intelligence from Kognita; custom MCPs add the external systems, app actions, and operational tools it is allowed to use.

What custom MCPs unlock

Kognita's built-in integrations cover codebase intelligence, Jira, and database access. Custom MCPs extend the same managed agent runtime to any MCP server your team approves. This matters for developers and for customers: the same assistant can understand the code, explain the system, and reach the connected tools that surround it.

  • Connect the Kognita managed project agent to approved external MCP servers, not only Kognita built-ins.
  • Bring internal tools, business systems, databases, ticketing systems, and automation platforms into the same agent runtime as your codebase context.
  • Use a hosted third-party MCP endpoint or host your own public HTTPS MCP server when your team wants to expose internal workflows safely.
  • Use Zapier MCP to expose approved app actions from Gmail, Slack, Google Calendar, Salesforce, HubSpot, Notion, Jira, and thousands of other apps.
  • Give product, support, operations, and management a single place to ask codebase questions and, when approved, reach connected systems.
  • Keep the agent grounded with explicit guidance that explains what each custom MCP does and when it should be used.

How it works in Kognita

1

Add a server

Open a project, go to MCPs, and add a public HTTPS MCP endpoint using Streamable HTTP or SSE.

2

Describe the tools

Write agent guidance that tells Kognita exactly what the MCP provides and when to use it.

3

Refresh runtime

Refresh the project environment so the managed agent can discover and use the new MCP tools.

4

Bring or host your own

Use a vendor-hosted MCP or run your own MCP server as long as it is reachable from Kognita over public HTTPS.

Network allowlist for self-hosted MCPs

If you host your own MCP server behind a firewall, reverse proxy, API gateway, or cloud security group, allow inbound HTTPS traffic from the same Kognita egress IP shown in the dashboard database setup: 35.254.19.175.

Kognita custom MCP URLs must still be public HTTPS endpoints. The allowlist is for teams that expose a controlled endpoint publicly but restrict which source IPs can reach it.

Zapier MCP example

Zapier documents MCP support for 8,000+ app connections and 30,000+ actions. In Kognita, that means a project agent can keep using semantic codebase context while also reaching approved Zapier tools, such as calendar lookup, Slack updates, CRM records, spreadsheet rows, or ticket actions.

01

Create a Zapier MCP server

Open Zapier MCP, click New MCP Server, and choose the MCP client type. For Kognita, choose Other so Zapier gives you a generic MCP server URL that can be pasted into a custom MCP connection.

Zapier MCP server creation screen showing popular AI agents and the Other client option selected.
Zapier MCP shows a new server flow with common AI clients and an Other option for generic MCP-compatible clients.
02

Add the app you want the agent to use

In the Zapier MCP Apps tab, add a tool and search for the app you want. This example searches for calendar tools and selects Google Calendar.

Zapier MCP Add tools dialog searching for calendar apps including Google Calendar.
The Add tools dialog in Zapier MCP searches for calendar apps and shows Google Calendar as one of the available app connections.
03

Choose exact tools and permissions

Select only the tools the Kognita agent should be able to use. You can add all available tools, only search tools, only action tools, or specific actions one by one.

Zapier MCP Google Calendar tool picker with selected find and action tools.
Zapier MCP lets you select Google Calendar tools such as finding calendars, checking busy periods, and retrieving calendar information.
04

Connect the app account

Choose the app account Zapier should use, then add the selected tools to the MCP server. The Kognita agent will only see the Zapier tools you configured for this server.

Zapier MCP Google Calendar connection step with an account selected and Add tools button.
The Google Calendar account connection step shows the selected account and the button to add the chosen tools to the MCP server.
05

Copy the Zapier MCP server URL

Open the Connect tab in Zapier MCP and copy the server URL. Treat this URL like a secret because it authorizes access to the tools configured on that Zapier MCP server.

Zapier MCP Connect tab showing the MCP server URL and token controls.
The Zapier MCP Connect tab displays a Streamable HTTP server URL and a token management option.
06

Add Zapier as a custom MCP in Kognita

In your Kognita project, open MCPs, click Add MCP server, choose Streamable HTTP, paste the Zapier server URL, and add clear agent guidance such as what the calendar tools are for.

Kognita Add custom MCP modal with Streamable HTTP, a Zapier MCP URL, and agent guidance.
Kognita custom MCP setup accepts a name, transport type, public HTTPS URL, optional headers, and agent guidance.
07

Refresh the environment and use the tools

After saving the custom MCP, refresh the project agent environment. The assistant can then use the configured external tools alongside Kognita semantic code intelligence, Jira, and database context.

Kognita MCPs page showing a configured Zapier Google Calendar custom MCP and the assistant connected tools panel.
The Kognita MCPs page shows a configured custom Google Calendar MCP and the assistant panel ready to use connected MCP tools.

Security notes

  • Only connect MCP servers you trust and that your organization has approved.
  • Use the smallest useful Zapier tool set instead of exposing every available action by default.
  • Treat external MCP URLs and tokens as secrets because they can grant access to configured external actions.
  • Use least-privilege external app accounts and rotate credentials when access changes.
  • Keep agent guidance specific so the agent knows the intended scope of each custom MCP server.

FAQ

What is a custom MCP server in Kognita?

A custom MCP server is an external Model Context Protocol server that you attach to a Kognita project. It lets the managed project agent use approved tools from that server while still grounding answers in Kognita semantic codebase intelligence.

How is a custom MCP different from the Kognita MCP?

The Kognita MCP lets outside tools like Claude Code, Cursor, Codex, and Windsurf query Kognita codebase context. A custom MCP works in the opposite direction: it lets the Kognita project agent connect to an approved external MCP server such as Zapier.

Can Kognita connect to Zapier MCP?

Yes. Zapier MCP provides a server URL for MCP-compatible clients. In Kognita, add that URL as a custom MCP using Streamable HTTP, describe what the tools are for, save it, and refresh the agent environment.

Which custom MCP servers can I connect?

Kognita supports public HTTPS custom MCP endpoints using Streamable HTTP or SSE. That can include hosted MCP servers from vendors, internal MCP services exposed safely over HTTPS, and automation platforms like Zapier MCP.

Are custom MCP headers secure?

Header values entered for a custom MCP are stored encrypted and are not shown again in full. Use least-privilege credentials and rotate external tokens whenever access changes.

What IP should I allowlist for a private or self-hosted MCP?

If your firewall, reverse proxy, or gateway restricts inbound traffic, allow inbound HTTPS access from the Kognita egress IP 35.254.19.175.

Next steps