Overview
The GiiS MCP servers let you connect any MCP-compatible AI tool to your GiiS account. Ask Claude, Codex, Cursor or any other MCP client to search your knowledge base, or save leads to your CRM, without leaving your workflow.
GiiS has two MCP servers:
| Server | Address | What it does |
|---|---|---|
| GiiS tools | https://chat.giis.ai/mcp | Search your knowledge base and the web, read pages, generate images, post to your connected social accounts |
| Sales & CRM tools | https://chat.giis.ai/mcp/sales-actions/mcp | Add and list CRM contacts and companies, review scraped leads, check your outreach summary |
Every call runs as you, with your plan and permissions. The Sales & CRM tools need a paid plan (Professional, Business or Enterprise).
Supported clients
Any client that supports the Model Context Protocol over HTTP works with GiiS, including:
- Claude Code and Claude Desktop
- Codex CLI
- Cursor
- Any other MCP-compatible client
Step 1: create a Personal Access Token
- Open chat.giis.ai and go to Settings.
- Find Access Tokens and create a new token. Give it a name you'll recognise, like "Claude Code".
- Copy the token. You'll only see it once.
Treat the token like a password: anyone with it can act as you in GiiS. Don't paste it into chats, emails or shared files. If it leaks, delete it in Settings and create a new one.
Step 2: add GiiS to your AI tool
Replace YOUR_GIIS_TOKEN with the token from step 1.
Claude Code
claude mcp add --transport http giis https://chat.giis.ai/mcp \
--header "Authorization: Bearer YOUR_GIIS_TOKEN"
claude mcp add --transport http giis-sales https://chat.giis.ai/mcp/sales-actions/mcp \
--header "Authorization: Bearer YOUR_GIIS_TOKEN"Codex CLI
Codex reads the token from an environment variable, so it never sits in a config file. Add this to your shell profile (for example ~/.bashrc or ~/.zshrc), then open a new terminal:
export GIIS_TOKEN="YOUR_GIIS_TOKEN"Then add this to ~/.codex/config.toml:
[mcp_servers.giis]
url = "https://chat.giis.ai/mcp"
bearer_token_env_var = "GIIS_TOKEN"
[mcp_servers.giis-sales]
url = "https://chat.giis.ai/mcp/sales-actions/mcp"
bearer_token_env_var = "GIIS_TOKEN"Cursor, Claude Desktop and other clients
Most clients accept this JSON:
{
"mcpServers": {
"giis": {
"url": "https://chat.giis.ai/mcp",
"headers": { "Authorization": "Bearer YOUR_GIIS_TOKEN" }
},
"giis-sales": {
"url": "https://chat.giis.ai/mcp/sales-actions/mcp",
"headers": { "Authorization": "Bearer YOUR_GIIS_TOKEN" }
}
}
}Step 3: try it
Ask your AI tool something like:
- "Search GiiS for our pricing notes."
- "Add Jane Smith, Head of Design at Example Co, jane@example.com, to my GiiS CRM as a lead."
- "List my newest CRM contacts."
Troubleshooting
| Problem | What to check |
|---|---|
| 401 Unauthorized | The token is missing, mistyped or deleted. Create a new one and update your tool's settings. |
| 403 Forbidden on CRM tools | The Sales & CRM tools need a paid plan. Check Billing in GiiS, or ask your workspace owner to add you as a team member. |
| Tools don't appear | Restart your AI tool after changing its settings, and check the address has no typos. |