Developers API & MCP

Conecta tus herramientas de IA a Nubiq. Gestiona conversaciones, busca documentos, monitorea analytics, todo desde Claude Code, Cursor o tus propios agentes.

Obtener API Key Ver en npm

Conectar desde Claude Code

Add Nubiq as an MCP server in Claude Code with a single command.

Terminal

claude mcp add nubiq --transport streamable-http \
  --url https://hub.nubiq.ai/api/mcp/ \
  --header "Authorization: Bearer YOUR_API_KEY"

Conectar desde Cursor

Add to your Cursor settings (.cursor/mcp.json):

.cursor/mcp.json

{
  "mcpServers": {
    "nubiq": {
      "transport": "streamable-http",
      "url": "https://hub.nubiq.ai/api/mcp/",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Conectar desde cualquier cliente MCP

Any MCP-compatible client can connect using the standard JSON-RPC 2.0 protocol over streamable HTTP.

Generic config

{
  "server": "https://hub.nubiq.ai/api/mcp/",
  "transport": "streamable-http",
  "auth": {
    "type": "bearer",
    "token": "YOUR_API_KEY"
  }
}

Referencia de herramientas

30 tools grouped by domain. Each tool requires an API key with the correct scope.

💬

Conversations

conversations.list
List conversations with filters
conversations:read
conversations.get
Get conversation details
conversations:read
conversations.search
Full-text search across conversations
conversations:read
conversations.update_status
Change conversation status
conversations:write
conversations.assign
Assign to agent or team
conversations:write
conversations.reply
Send agent reply
conversations:write

🎫

Tickets

tickets.list
List support tickets
tickets:read
tickets.get
Get ticket detail
tickets:read
tickets.create
Create a new ticket
tickets:write
tickets.update
Update ticket fields
tickets:write
tickets.close
Close a ticket
tickets:write

📄

Documents

documents.list
List knowledge base documents
documents:read
documents.search
Semantic search over documents
documents:read
documents.upload
Upload a new document
documents:write
documents.delete
Delete a document
documents:write
documents.reindex
Trigger reindex job
documents:write

👤

Contacts

contacts.list
List contact profiles
contacts:read
contacts.get
Get contact details
contacts:read
contacts.search
Search contacts by field
contacts:read

📊

Analytics

analytics.overview
KPI summary dashboard
analytics:read
analytics.conversations
Conversation metrics over time
analytics:read
analytics.satisfaction
CSAT and feedback scores
analytics:read

🔌

Channels

channels.list
List configured channels
channels:read
channels.get
Get channel config
channels:read
channels.send
Send outbound message
channels:write

🎨

Widget

widget.list
List widget configs
widget:read
widget.get
Get widget details
widget:read
widget.update
Update widget settings
widget:write

👥

Team

team.members
List team members
team:read
team.invite
Invite a new member
team:write

Autenticacion

Obtener API Key

Sign in to your Nubiq dashboard
Go to Settings → API Keys
Click Create API Key
Select the scopes you need and set an expiration date
Copy the key immediately — it will not be shown again

Scopes disponibles

Scope	Description
conversations:read	Read conversations and messages
conversations:write	Reply, assign, close conversations
tickets:read	Read tickets
tickets:write	Create and update tickets
documents:read	List and search documents
documents:write	Upload, delete, reindex documents
contacts:read	Read contact profiles
analytics:read	Read analytics and metrics
channels:read	Read channel configs
channels:write	Send messages to channels
widget:read	Read widget configs
widget:write	Update widget settings
billing:read	Read billing and usage
team:read	List team members
team:write	Invite members, manage roles
notifications:read	Read notification events

Rate Limits

Plan	Requests/min	Requests/day
Pro	60	10,000
Enterprise	300	100,000