--- title: "Connect an AI agent with SKILL.md, MCP or the API" url: "https://conecto.chat/docs/connect" markdown: "https://conecto.chat/docs/connect.md" description: "Four ways in to Conecto: SKILL.md, an MCP server for each area, one connector with sign-in for ChatGPT, Claude and Copilot Studio, and REST with OpenAPI." section: "Get started" published: 2026-10-19 updated: 2026-10-21 --- # Connect your agent Every way in reaches the same tools, the same account and the same balance. Use the one your agent supports, or several at once. ## SKILL.md https://conecto.chat/SKILL.md is the file an agent keeps. It says how to sign up, call tools, pay and keep the business safe, then lists every area with its prices and tools. An agent that reads it signs itself up with one call. Give this to your agent: ```text Set up Conecto from https://conecto.chat/SKILL.md ``` Agents that look for skills on their own find it at https://conecto.chat/.well-known/agent-skills/index.json. [For agents](https://conecto.chat/docs/for-agents.md) lists its sections and its digest. A Conecto partner's link adds `?ref=` to the address, and the file then puts their code in its signup example. ## MCP servers One MCP server holds every area a key may use, `https://api.conecto.chat/v1/mcp`, over Streamable HTTP. Calling a tool needs the key in the `Authorization` header. An agent adds it once, right after signing up, with the key typed in that one command: Terminal: ```bash claude mcp add --transport http --scope user conecto https://api.conecto.chat/v1/mcp \ --header "Authorization: Bearer $CONECTO_KEY" ``` Each area also has a server of its own at `https://api.conecto.chat/mcp/`, for an agent that wants only some areas. Listing its tools needs no key, and it carries the account tools too, like `account_balance`. A key limited to some areas or tools sees only those in `tools/list`. [Calling tools](https://conecto.chat/docs/calling-tools.md#over-mcp) shows a call and its reply over MCP. ## The connector with sign-in Assistants that people use, like ChatGPT, Claude and Grok, and agents built in Copilot Studio, sign in with OAuth at one address for every area, `https://api.conecto.chat/v1/mcp`. Add it as a custom connector (in Copilot Studio, a Model Context Protocol tool), sign in to Conecto, tick the areas the app may use and allow it. - The owner signs in with the session they have on conecto.chat. Anyone else on the account signs in with a link emailed to them, or through the company's single sign-on. - They pick the account and tick the areas. The business's areas are ticked already, and Select all ticks every one. The connection then runs on a key of its own, limited to those areas, so it shows with the account's other keys and is revoked like them. - Tools that move money, like topping up, stay out of the connector whatever is ticked. - A token works only on the connector's address. An access token lasts 1 hour, and a refresh token 30 days. - Someone on the account besides the owner connects as themselves. The key is theirs, named like "Ben, through Claude", and works within their teams and role. Removing them from the account ends it at once. - The owner can list the apps people may connect. An app that signs people in from anywhere else is refused. The sign-in follows OAuth 2.1 with PKCE, dynamic client registration and resource indicators, and refresh tokens change with each use. The connector's metadata is at `https://api.conecto.chat/.well-known/oauth-protected-resource/v1/mcp`, and [For agents](https://conecto.chat/docs/for-agents.md#oauth) shows it. ## REST and OpenAPI Any code that speaks HTTPS calls `POST https://api.conecto.chat/v1/tools/`. These OpenAPI files describe it: | File | Address | For | | --- | --- | --- | | Every route and tool | `https://api.conecto.chat/v1/openapi.json` | OpenAPI 3.1, for your own code and API clients. | | One area | `https://api.conecto.chat/v1/openapi/.json` | OpenAPI 3.0, with descriptions short enough for a custom GPT's Actions to import. OpenAI retires custom GPTs on December 11, 2026, so in ChatGPT use the connector. | | One area, OpenAPI 2.0 | `https://api.conecto.chat/v1/openapi/.swagger.json` | Power Automate, Logic Apps and Copilot Studio. The key goes in the `X-Api-Key` header. | An area's file also carries the account tools. In the file for a custom GPT, a tool that only reads is marked so ChatGPT can offer to always allow it. [The REST API](https://conecto.chat/docs/api.md) has every route. ## Setup pages for each agent Each page gives the steps from that agent's own docs, with the addresses to paste. - [Claude](https://conecto.chat/agents/claude.md): Custom connector. - [ChatGPT](https://conecto.chat/agents/chatgpt.md): Custom MCP server. - [Grok](https://conecto.chat/agents/grok.md): Custom connector. - [Claude Code](https://conecto.chat/agents/claude-code.md): SKILL.md and a setup line. - [Cursor](https://conecto.chat/agents/cursor.md): mcp.json. - [Codex](https://conecto.chat/agents/codex.md): SKILL.md and a setup line. - [Gemini CLI](https://conecto.chat/agents/gemini-cli.md): settings.json. - [OpenClaw](https://conecto.chat/agents/openclaw.md): SKILL.md and a setup line. - [Hermes Agent](https://conecto.chat/agents/hermes-agent.md): SKILL.md and a setup line. ## Every area's addresses Add the areas the business uses. Each link opens the area's tools. Assistants that sign in use one connector for every area: `https://api.conecto.chat/v1/mcp`. Agents with a key use each area's MCP server. | Area | MCP server | | --- | --- | | [CRM](https://conecto.chat/tools/crm.md) | `https://api.conecto.chat/mcp/crm` | | [Prospects](https://conecto.chat/tools/prospects.md) | `https://api.conecto.chat/mcp/prospects` | | [Outreach](https://conecto.chat/tools/outreach.md) | `https://api.conecto.chat/mcp/outreach` | | [Email](https://conecto.chat/tools/email.md) | `https://api.conecto.chat/mcp/email` | | [Website chat](https://conecto.chat/tools/chat.md) | `https://api.conecto.chat/mcp/chat` | | [Phone](https://conecto.chat/tools/phone.md) | `https://api.conecto.chat/mcp/phone` | | [Calendar](https://conecto.chat/tools/calendar.md) | `https://api.conecto.chat/mcp/calendar` | | [Help desk](https://conecto.chat/tools/helpdesk.md) | `https://api.conecto.chat/mcp/helpdesk` | | [Help center](https://conecto.chat/tools/helpcenter.md) | `https://api.conecto.chat/mcp/helpcenter` | | [Forms](https://conecto.chat/tools/forms.md) | `https://api.conecto.chat/mcp/forms` | | [Company & email lookups](https://conecto.chat/tools/lookups.md) | `https://api.conecto.chat/mcp/lookups` | | [Newsletters](https://conecto.chat/tools/newsletters.md) | `https://api.conecto.chat/mcp/newsletters` | | [Social](https://conecto.chat/tools/social.md) | `https://api.conecto.chat/mcp/social` | | [Websites](https://conecto.chat/tools/websites.md) | `https://api.conecto.chat/mcp/websites` | | [Website analytics](https://conecto.chat/tools/analytics.md) | `https://api.conecto.chat/mcp/analytics` | | [AI visibility](https://conecto.chat/tools/visibility.md) | `https://api.conecto.chat/mcp/visibility` | | [Links & QR codes](https://conecto.chat/tools/links.md) | `https://api.conecto.chat/mcp/links` | | [Invoices](https://conecto.chat/tools/invoices.md) | `https://api.conecto.chat/mcp/invoices` | | [Bookkeeping](https://conecto.chat/tools/books.md) | `https://api.conecto.chat/mcp/books` | | [Purchasing](https://conecto.chat/tools/purchasing.md) | `https://api.conecto.chat/mcp/purchasing` | | [Inventory](https://conecto.chat/tools/inventory.md) | `https://api.conecto.chat/mcp/inventory` | | [Company data](https://conecto.chat/tools/companies.md) | `https://api.conecto.chat/mcp/companies` | | [Valuation](https://conecto.chat/tools/valuation.md) | `https://api.conecto.chat/mcp/valuation` | | [Longlists](https://conecto.chat/tools/longlists.md) | `https://api.conecto.chat/mcp/longlists` | | [Market data](https://conecto.chat/tools/markets.md) | `https://api.conecto.chat/mcp/markets` | | [Mergers & acquisitions](https://conecto.chat/tools/mergers.md) | `https://api.conecto.chat/mcp/mergers` | | [HR](https://conecto.chat/tools/hr.md) | `https://api.conecto.chat/mcp/hr` | | [Hiring](https://conecto.chat/tools/hiring.md) | `https://api.conecto.chat/mcp/hiring` | | [Whistleblowing](https://conecto.chat/tools/whistleblowing.md) | `https://api.conecto.chat/mcp/whistleblowing` | | [Directory](https://conecto.chat/tools/directory.md) | `https://api.conecto.chat/mcp/directory` | | [Microsoft 365](https://conecto.chat/tools/microsoft365.md) | `https://api.conecto.chat/mcp/microsoft365` | | [Google Workspace](https://conecto.chat/tools/googleworkspace.md) | `https://api.conecto.chat/mcp/googleworkspace` | | [HubSpot](https://conecto.chat/tools/hubspot.md) | `https://api.conecto.chat/mcp/hubspot` | | [Salesforce](https://conecto.chat/tools/salesforce.md) | `https://api.conecto.chat/mcp/salesforce` | | [Connections](https://conecto.chat/tools/connect.md) | `https://api.conecto.chat/mcp/connect` | | [Import](https://conecto.chat/tools/imports.md) | `https://api.conecto.chat/mcp/imports` | | [Projects](https://conecto.chat/tools/projects.md) | `https://api.conecto.chat/mcp/projects` | | [E-signature](https://conecto.chat/tools/esign.md) | `https://api.conecto.chat/mcp/esign` | | [Documents](https://conecto.chat/tools/documents.md) | `https://api.conecto.chat/mcp/documents` | | [Files](https://conecto.chat/tools/files.md) | `https://api.conecto.chat/mcp/files` | | [Tables](https://conecto.chat/tools/tables.md) | `https://api.conecto.chat/mcp/tables` | | [Views](https://conecto.chat/tools/views.md) | `https://api.conecto.chat/mcp/views` | | [Notifications](https://conecto.chat/tools/notify.md) | `https://api.conecto.chat/mcp/notify` | | [Schedules](https://conecto.chat/tools/schedules.md) | `https://api.conecto.chat/mcp/schedules` | | [Uptime](https://conecto.chat/tools/uptime.md) | `https://api.conecto.chat/mcp/uptime` | | [Vault](https://conecto.chat/tools/vault.md) | `https://api.conecto.chat/mcp/vault` | | [Code](https://conecto.chat/tools/code.md) | `https://api.conecto.chat/mcp/code` | | [Account](https://conecto.chat/tools/account.md) | `https://api.conecto.chat/mcp/account` | | [Account admin](https://conecto.chat/tools/admin.md) | `https://api.conecto.chat/mcp/admin` | | [Web](https://conecto.chat/tools/web.md) | `https://api.conecto.chat/mcp/web` | | [Speech](https://conecto.chat/tools/speech.md) | `https://api.conecto.chat/mcp/speech` | | [Images](https://conecto.chat/tools/images.md) | `https://api.conecto.chat/mcp/images` | ## More in the docs - Previous: [Quickstart](https://conecto.chat/docs/quickstart.md) - Next: [Conecto in Claude](https://conecto.chat/docs/claude-connector.md) - Every page in one file: https://conecto.chat/docs/all.md - Every page's title and address: https://conecto.chat/docs/index.json