One

One MCP Server

Website  ·  Docs  ·  Dashboard  ·  Changelog  ·  X  ·  LinkedIn

Conecte seus agentes de IA a mais de 700 aplicativos por meio de um único servidor MCP. Encontre as ações que uma tarefa precisa com sua documentação e execute chamadas de API entre plataformas, sem precisar gerenciar tokens OAuth ou chaves de API.

npm install -g @withone/cli
one init

É isso. O One CLI solicitará sua chave de API (obtenha uma no painel do One) e configurará o servidor MCP para seu ambiente: Claude Desktop, Cursor, Claude Code, Windsurf ou qualquer agente compatível com MCP.

Recursos

• Mais de 700 plataformas. Gmail, Slack, Shopify, HubSpot, Stripe, Linear, QuickBooks e mais.
• Execução em linguagem natural. "leia meu último e-mail do Gmail", "envie uma mensagem para #geral no Slack"
• Geração de código. "crie um formulário para enviar e-mails usando Gmail", "crie um painel que liste meus projetos do Linear"
• Sem excesso de ferramentas. Apenas 3 ferramentas expostas, independentemente de quantas plataformas ou ações você conectar. Uma chamada encontra cada ação que uma tarefa precisa, entre plataformas, com sua documentação, mantendo a janela de contexto do seu agente limpa.
• Controle de acesso granular. Restrinja quais ações, conexões e níveis de permissão (leitura, escrita, administrador) seu agente pode acessar.
• Seguro por padrão. Todas as solicitações são proxy através do One, segredos são automaticamente ocultados, sem chaves de API de plataforma para gerenciar.

Exemplos

Execute ações diretamente:

"Obtenha meus últimos 5 e-mails do Gmail"

"Envie uma mensagem no Slack para #geral: 'Reunião em 10 minutos'"

"Obtenha todos os produtos da minha loja Shopify"

Gere código de integração:

"Crie um componente de formulário React que envie e-mails usando Gmail"

"Crie um painel que exiba usuários do Linear e seus projetos atribuídos com filtragem"

"Crie uma tabela paginável que busque e exiba faturas do QuickBooks com pesquisa e ordenação"

Ferramentas

O servidor expõe três ferramentas MCP:

Ferramenta	Descrição
list_one_integrations	Lista plataformas disponíveis e conexões ativas, cada uma com o access que confere (completo, métodos ou ações específicas)
find_one_actions	Encontra a ação para cada operação que uma tarefa precisa, entre plataformas, com sua documentação, em uma única chamada; load busca mais de um documento ou de uma alternativa
execute_one_action	Executa uma ação de API em uma plataforma conectada

Encontrando ações

find_one_actions recebe uma entrada requests por operação, cada uma com um platform em kebab-case e um intent curto nomeando a operação isoladamente ("send a message to a channel", não a mensagem). Um task descreve o trabalho inteiro em termos gerais, e um ai_model nomeia o modelo que está perguntando; os agentes são solicitados a enviar ambos em cada busca, pois a tarefa ajuda a distinguir ações semelhantes. Para cada intenção, o modelo de decisão do One escolhe a ação a ser usada; a resposta a documenta, destaca um substituto quando o modelo não tinha certeza e lista algumas alternativas. Documentos grandes retornam como um resumo; chame find_one_actions novamente com load: [{ action_id, section }] para uma seção omitida, full: true para o documento inteiro ou toc: true para seu sumário. ONE_ACTION_IDS, ONE_PERMISSIONS e ONE_CONNECTION_KEYS se aplicam a cada resposta: uma ação que recusam nunca é oferecida, e quando recusam a escolha do modelo, o próximo candidato permitido assume seu lugar.

Atualizando da versão 1.x: search_one_platform_actions e get_one_action_knowledge foram removidos. find_one_actions substitui ambos.

Servidor MCP Remoto

Prefere não executar nada localmente? O One hospeda um servidor MCP remoto em https://mcp.withone.ai/mcp. Aponte qualquer cliente MCP que suporte servidores remotos (HTTP) para essa URL e autentique-se com o One via OAuth. Não há npm install nem ONE_SECRET para gerenciar. Você aprova o acesso na tela de consentimento do One, onde pode definir exatamente quais conexões, ações e níveis de permissão o agente recebe. Essas escolhas são refletidas de volta ao agente por meio do campo access de cada conexão, para que ele saiba o que pode executar sem pesquisar.

Adicione-o à configuração MCP do seu cliente. O endpoint fala o transporte HTTP Streamable:

{
  "mcpServers": {
    "one": {
      "type": "http",
      "url": "https://mcp.withone.ai/mcp"
    }
  }
}

Alguns clientes omitem type e aceitam apenas a URL; clientes baseados em interface (conectores personalizados) precisam apenas da URL. Na primeira conexão, seu cliente abre um navegador para autenticar e autorizar com o One. Depois disso, as mesmas três ferramentas estão disponíveis.

Instalação com um clique:

O link do Windsurf abre a página do One no marketplace MCP do editor, que é servido a partir do registro MCP oficial onde o One é publicado como ai.withone/mcp. O Windsurf lida com o login OAuth por conta própria quando você instala a partir dessa página.

Instalação Manual

Se você preferir configurar o servidor manualmente em vez de usar one init, instale o pacote diretamente:

npm install @withone/mcp

Em seguida, defina a variável de ambiente necessária:

ONE_SECRET=your-one-secret-key

Escopo de Identidade

Defina o escopo das conexões para uma identidade específica (por exemplo, um usuário, equipe ou organização):

ONE_IDENTITY=user_123
ONE_IDENTITY_TYPE=user

Variável	Descrição	Valores
ONE_IDENTITY	O identificador da entidade (por exemplo, ID do usuário, ID da equipe)	Qualquer string
ONE_IDENTITY_TYPE	O tipo de identidade	user, team, organization, project

Quando definido, o servidor MCP retornará apenas conexões associadas à identidade especificada. Isso é útil para aplicativos multi-tenant onde você deseja definir o escopo das integrações para usuários ou entidades específicas.

Controle de Acesso

Ajuste o que o servidor MCP pode ver e fazer:

ONE_PERMISSIONS=read
ONE_CONNECTION_KEYS=conn_key_1,conn_key_2
ONE_ACTION_IDS=action_id_1,action_id_2
ONE_KNOWLEDGE_AGENT=true

Variável	Tipo	Padrão	Descrição
ONE_PERMISSIONS	read | write | admin	admin	Filtra ações por método HTTP. read = somente GET, write = GET/POST/PUT/PATCH, admin = todos os métodos
ONE_CONNECTION_KEYS	* ou chaves separadas por vírgula	*	Restringe conexões e plataformas visíveis a chaves de conexão específicas
ONE_ACTION_IDS	* ou IDs separados por vírgula	*	Restringe ações visíveis e executáveis a IDs de ação específicos
ONE_KNOWLEDGE_AGENT	true | false	false	Remove a ferramenta execute_one_action completamente, forçando o modo somente conhecimento. find_one_actions então retorna o documento completo de cada ação escolhida com como chamá-la a partir do código, e um Guia de Código de Integração (URL de passagem, cabeçalhos x-one-*, variáveis de ambiente ONE_SECRET / ONE_{PLATFORM}_CONNECTION_KEY, posicionamento somente no backend) para escrever código de aplicação

Todos os padrões preservam o comportamento atual. Se nenhuma variável de ambiente de controle de acesso for definida, o servidor inicia com acesso total e todas as ferramentas disponíveis.

O que você configurar aqui é refletido de volta ao agente: list_one_integrations carimba cada conexão com um campo access para que o agente saiba antecipadamente o que pode executar ali, sem gastar uma rodada pesquisando. É um dos seguintes:

access	Quando
{ "policy": "full" }	Sem lista de permissão de ações e ONE_PERMISSIONS=admin — toda ação é executável.
{ "policy": "methods", "methods": ["GET", ...] }	Sem lista de permissão de ações, mas ONE_PERMISSIONS é read/write — apenas esses métodos HTTP são executáveis.
{ "policy": "actions", "actions": [{ "actionId", "title", "method" }] }	ONE_ACTION_IDS está definido — exatamente essas ações (as da plataforma daquela conexão) são executáveis, então nenhuma pesquisa é necessária.

Configuração Manual

Se você usou one init, a configuração abaixo já está feita para você. Estes exemplos são para referência ou configurações manuais.

Autônomo

npx @withone/mcp

Claude Desktop / Cursor

Adicione o seguinte à sua configuração MCP:

• Claude Desktop: MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json · Windows: %APPDATA%/Claude/claude_desktop_config.json
• Cursor: Abra o menu do Cursor e selecione "Configurações MCP"

{
  "mcpServers": {
    "one": {
      "command": "npx",
      "args": ["@withone/mcp"],
      "env": {
        "ONE_SECRET": "your-one-secret-key"
      }
    }
  }
}

Docker

docker build -t one-mcp-server .
docker run -e ONE_SECRET=your_one_secret_key one-mcp-server

Todas as variáveis de ambiente listadas acima podem ser passadas como flags -e.

Segurança

Todas as solicitações a plataformas de terceiros são autenticadas e passam por proxy através da API do One. O servidor MCP nunca lida diretamente com tokens OAuth ou chaves de API de plataforma. A chave ONE_SECRET é a única credencial necessária, e é automaticamente ocultada de todas as cargas de resposta retornadas aos clientes. Cabeçalhos sensíveis são removidos das configurações de solicitação registradas e retornadas.

Licença

MIT

Suporte

Para suporte, entre em contato com support@withone.ai ou visite https://withone.ai