diff --git a/agents/available-connections.mdx b/agents/available-connections.mdx new file mode 100644 index 00000000..e9d6b239 --- /dev/null +++ b/agents/available-connections.mdx @@ -0,0 +1,446 @@ +--- +title: Available Connections +sidebarTitle: Available Connections +description: +--- + +Below is a curated sample—search the catalog of Connections in your Workspace or agent card for the full list. + +### Commerce + + + +
+ + CoinMarketCap +
+ CoinMarketCap is a website that provides cryptocurrency market cap rankings, charts, and more. + + +
+ + Stripe +
+ Stripe powers online and in-person payment processing and financial solutions for businesses of all sizes. + + + +### Communication + + + +
+ + Discord +
+ Create a Discord source that emits messages from your guild to a Hypermode workflow. + + +
+ + Gmail +
+ Gmail offers private and secure email by Google at no cost, for business and consumer accounts. + + +
+ + Microsoft Outlook +
+ Microsoft Outlook lets you bring all your email accounts and calendars in one convenient spot. + + +
+ + Slack +
+ Slack is a messaging platform for team communication. + + +
+ + Telegram +
+ Telegram is a cloud-based, cross-platform, encrypted instant messaging (IM) service. + + + +### Data analytics + + + +
+ + Alpha Vantage +
+ Free stock APIs in JSON & Excel. + + +
+ + Google Analytics +
+ Measure and report on user activity across websites, apps, and devices. + + + +### Database + + + +
+ + Neo4j AuraDB +
+ Fully managed graph database. + + +
+ + Supabase +
+ Supabase is an open‑source Firebase alternative. + + +
+ + Weaviate +
+ Weaviate is an open‑source vector database. + + + +### Development tools + + + +
+ + AgentQL +
+ Make the Web AI-Ready. + + +
+ + Browserbase +
+ A web browser for AI agents & applications. + + +
+ + Exa +
+ Exa is an AI-powered search and retrieval platform. + + +
+ + GitHub +
+ GitHub is a web-based Git repository hosting service. + + +
+ + Hyperbrowser +
+ Cloud browsers for your AI agents. + + +
+ + Jira +
+ Jira is the #1 agile project management tool used by teams to plan, track, release, and support great software with confidence. + + +
+ + Ref +
+ Ref is a service for finding references. + + + +### Entertainment + + + +
+ + Google Maps (Places API) +
+ Find what you need by getting the latest information on businesses and other important places with Google Maps. + + +
+ + Spotify +
+ Spotify is a digital music service that gives you access to millions of songs. + + +
+ + Strava +
+ Designed by athletes, for athletes, Strava's mobile app and website connect millions of runners and cyclists through the sports they love. + + + +### File storage + + + +
+ + Box +
+ Platform for secure content management, workflow, and collaboration. + + +
+ + Dropbox +
+ Dropbox gives you secure access to all your files and lets you collaborate from any device. + + +
+ + Google Docs +
+ Use Google Docs to create, edit and collaborate on online documents. + + +
+ + Google Drive +
+ Google Drive lets you store and synchronize files online and access them from anywhere. + + + +### Infrastructure & cloud + + + +
+ + Google +
+ Internet-related services and products. + + +
+ + Cal.com +
+ Scheduling infrastructure for absolutely everyone. + + +
+ + Vercel +
+ Vercel is a platform for frontend frameworks and static sites. + + + +### Marketing + + + +
+ + Ahrefs +
+ SEO tools & resources. + + +
+ + AirOps +
+ Build and scale LLM-powered workflows and chat assistants using AirOps Studio. + + +
+ + Facebook Pages +
+ Social media and social networking service. + + +
+ + LinkedIn +
+ LinkedIn is a business and employment-focused social media platform. Manage your professional identity. Build and engage with your professional network. Access knowledge, insights, and opportunities. + + +
+ + Meetup +
+ Whatever you're looking to do this year, Meetup can help. + + +
+ + Product Hunt +
+ The best new products in tech. + + +
+ + Reddit +
+ Reddit is a network of communities based on people's interests. + + + +### Productivity + + + +
+ + Airtable +
+ Airtable is a low-code platform to build next-gen apps. Move beyond rigid tools, operationalize your critical data, and reimagine workflows with AI. + + +
+ + Asana +
+ Work anytime, anywhere with Asana. Keep remote and distributed teams, and your entire organization, focused on their goals, projects, and tasks with Asana. + + +
+ + Basecamp +
+ Project Management & Team Communication. + + +
+ + CompanyCam +
+ The photo app every contractor needs. + + +
+ + Fireflies +
+ Fireflies.ai helps your team transcribe, summarize, search, and analyze voice conversations. + + +
+ + Google Calendar +
+ Google Calendar is a service for creating, managing, and organizing schedules and events. + + +
+ + Google Sheets +
+ Use Google Sheets to create and edit online spreadsheets. Get insights together with secure sharing in real-time and from any device. + + +
+ + iLovePDF +
+ iLovePDF is an online service to work with PDF files completely free and easy to use. Merge PDF, split PDF, compress PDF, office to PDF, and more. + + +
+ + Linear +
+ Linear is an issue tracking tool for software teams. + + +
+ + Microsoft 365 +
+ Your productivity cloud across work and life. + + +
+ + Microsoft OneDrive +
+ Microsoft OneDrive lets you store your personal files in one place, share them with others, and get to them from any device. + + +
+ + Microsoft Outlook Calendar +
+ The calendar and scheduling component of Outlook that's fully integrated with email, contacts, and other features. + + +
+ + Notion +
+ Notion is a service for notes, docs, tasks, and databases. + + +
+ + Teamwork +
+ Project management software. + + + + +### Sales + + + +
+ + Attio +
+ Customer relationship magic. Powerful, flexible, and data-driven, Attio makes it easy to build the exact CRM your business needs. + + +
+ + Google Contacts +
+ Google Contacts is a contact management service developed by Google. This service is backed by the Google People API. + + +
+ + HubSpot +
+ HubSpot's CRM platform contains the marketing, sales, service, operations, and website-building software you need to grow your business. + + +
+ + Salesforce +
+ Cloud-based customer relationship management (CRM) platform that helps businesses manage sales, marketing, customer support, and other business activities, ultimately aiming to improve customer relationships and streamline operations. + + + + + +Need an integration that isn't in the catalog? [Let us know](https://hypermode.com/). + diff --git a/agents/connections.mdx b/agents/connections.mdx index 1e6d8c20..04492589 100644 --- a/agents/connections.mdx +++ b/agents/connections.mdx @@ -1,172 +1,85 @@ --- title: "Connections" -sidebarTitle: "Connect Your Agent" +sidebarTitle: "Overview" description: - "Build AI agents that act, not just chat—from natural conversation to - production-ready code" + "All the capabilities your agent needs to take action across your stack" --- -**Connections** enable Hypermode Agents to securely access and interact with -external tools, APIs, and services. With over 2,000+ available integrations, -agents can execute tasks across your entire technology stack. - -- **Built-in integrations** like GitHub, Linear, Slack, Vercel, and Notion -- **Model Context Protocol** support for secure, structured tool integration -- **2,000+ integrations** through our partnership with leading automation - platforms -- **Your custom APIs** with encrypted credentials and scoped access -- **Major large language models** including OpenAI, Anthropic, Google, and open - source models +**Connections** enable Hypermode Agents to securely access and interact with external tools, APIs, and services. With over 2,000 available integrations, agents can execute tasks across your entire technology stack. ## Overview -Hypermode Agents are built for execution, not just conversation. Connections -provide the bridge between your agents and the tools they need to complete -tasks, from internal APIs to third-party applications and public resources. - -## Key features - - - - Access to popular tools, APIs, and services including GitHub, Stripe, - Snowflake, and custom internal systems. - - - - Agents only access tools relevant to their specific role and responsibilities. - - - - Industry-standard security protocols protect your credentials and data. - - - - Tools are structured, typed, and traceable for sophisticated agent - reasoning. - - - -## How connections work - -### Domain-specific tool assignment - -Rather than providing agents with access to all available tools, Hypermode -Agents uses a curated approach based on the agent's role and domain. Examples of -connections relevant for domain specific agents include: - -#### Frontend development agent - -- GitHub (code repository management) -- Linear (issue tracking) -- Vercel (deployment and hosting) +A Connection is a secure link between your agent and an external service (for example GitHub, Slack, Stripe, or your internal APIs). Connections allow agents to perform actions, retrieve data, and automate flows using these services. -#### Revenue operations agent +- **2,000+ integrations** to connect to popular tools across development, analytics, productivity, marketing, finance, and more. +- **Role-based access control** limits agent access to only the necessary tools and permissions +- **Audit logging** tracks all agent interactions with external services for compliance and troubleshooting +- **Powered by Model Context Protocol** for secure, structured, and context-aware tool interactions +- **Custom API support** with encrypted credentials and scoped access -- Snowflake (data warehousing) -- Stripe (payment processing) -- Internal ticketing API (customer support) +## Getting started -#### Marketing agent +### Add a connection -- HubSpot (CRM and automation) -- Google Analytics (website analytics) -- Mailchimp (email marketing) +Open the information details of your agent. Select a connection from the "add connections" from the left navigation bar or search from more than 2,000 connection options. -### Role-based access control +Add a new connection - - Agents are granted access only to tools that align with their designated role, - improving both security and decision-making clarity. - +### Authenticate -1. **Define agent role** and primary responsibilities -2. **Select relevant tools** from the curated toolkit -3. **Configure permissions** for each integration -4. **Monitor usage** and adjust access as needed +You'll be prompted to complete the OAuth flow if you haven't enabled the connection yet for your workspace. -## MCP +Once authenticated, save the changes made to the agent. -Connections leverage the Model Context Protocol (MCP) to provide agents with -enhanced tool interaction capabilities: +All connections use secure authentication methods including OAuth 2.0, API keys, and service account credentials. Credentials are encrypted and never exposed to the agent’s reasoning process. -### Benefits of MCP Integration +### Manage connections - - - Agents understand tool capabilities and parameters as clearly as they - understand text, enabling better planning and execution. - +Existing connections can be viewed and managed from the "Connections" tab in the +Workspace settings page. Connections can also be added to your workspace from +this page. - - Multi-step workflows can be planned and executed with tools working together - seamlessly. - +![Manage connections](/images/agents/connections-manage.png) - - Structured tool calls provide clear audit trails and error diagnosis - capabilities. - +### Edit or remove connections - - Consistent tool definitions enable agents to reuse and combine tools - effectively. - - +Update credentials, change permissions, or remove connections at any time form the "Connections" tab in your agent information card or in the Workspace settings page. -## Security and compliance + + Start with a small set of essential tools for your agent's role, then expand + as you identify additional needs through usage patterns. + - - All connections use secure authentication methods including OAuth 2.0, API - keys, and service account credentials. Credentials are encrypted and never - exposed to the agent's reasoning process. - +## FAQs -### Security features +**Why am I seeing a “token not found” or “failed to get connection token” error?** -- **Encrypted credential storage** with enterprise-grade security -- **Audit logging** for all tool interactions -- **Permission scoping** to limit access to necessary resources only -- **Regular security updates** and compliance monitoring +This error usually means the connection’s credentials are missing, expired, or weren't saved correctly. Please re-authenticate the connection in Workspace Settings > Connections. If the issue persists, ensure you have completed the OAuth flow and granted all required permissions. -## Getting started +**My agent can’t access my repositories, calendar, or Notion page even though I connected the service. What should I do?** -### Add a new connection +Double-check that you completed the OAuth authorization and selected the correct account or workspace. Some services require you to explicitly grant access to specific resources (for example repositories, calendars, pages). You can update these permissions in your service’s settings or by reconnecting the integration. -Select a connection from the "add connections"ption from the left navigation bar -or search from more than 2000 connection options. You'll be prompted to complete -the OAuth flow if you haven't enabled the connection yet for your workspace. +**Is there a way to add or manage connections directly from the agent setup flow?** -Add a new connection +Yes. You can add new connections during agent creation. Look for the “Add Connection” tab in your agent card once the agent is created. -### Manage connections +**Can one connection power multiple agents?** -Existing connections can be viewed and managed from the "Connections" tab in the -Workspace settings page. Connections can also be added to your workspace from -this page. +Yes. Connections are created at the Workspace level and can be assigned to multiple agents. You can grant access to the same connection for any agents that need it. -![Manage connections](/images/agents/connections-manage.png) +**Can I connect to a service not listed in the catalog?** - - Start with a small set of essential tools for your agent's role, then expand - as you identify additional needs through usage patterns. - +Custom integrations can be built for internal APIs and proprietary systems. Contact us for assistance with custom connection development. -## Available Integrations +**How do I restrict agent access to sensitive data?** -Popular integration categories include: +Hypermode uses OAuth to connect to external services, allowing you to grant only the minimum required permissions (scopes) for each agent. Use role-based access control and permission scoping when assigning connections to agents to ensure they only access the data and actions necessary for their tasks. -- **Development Tools**: GitHub, GitLab, Jira, Linear -- **Data & Analytics**: Snowflake, BigQuery, Tableau, Looker -- **Customer Success**: Salesforce, HubSpot, Zendesk, Intercom -- **Finance**: Stripe, QuickBooks, Xero, PayPal -- **Marketing**: Mailchimp, Constant Contact, Google Ads, Facebook Ads -- **Productivity**: Slack, Microsoft Teams, Google Workspace, Notion +**How do I know which permissions or scopes are being requested during OAuth?** - - Custom integrations can be built for internal APIs and proprietary systems. - Contact us for assistance with custom connection development. - +During the OAuth flow, you’ll see a list of permissions requested by Hypermode. Only the minimum required scopes are requested for the tools you assign to your agent. You can review and adjust these permissions in your service’s settings. diff --git a/docs.json b/docs.json index 1621e380..7c5ec341 100644 --- a/docs.json +++ b/docs.json @@ -61,7 +61,13 @@ "agents/introduction", "agents/create-agent", "agents/work", - "agents/connections", + { + "group": "Connect Your Agent", + "pages": [ + "agents/connections", + "agents/available-connections" + ] + }, "agents/tasks", "agents/model-selection", {